LILO
릴로(LILO)는 플레이시티 블록의 위치 정보 통계 시스템으로, 플레이시티 블록 지도 공간 정보 플랫폼의 핵심 기능 중 하나이다. LILO는 LIVE LOCATIONS의 약자이다.
마인크래프트 서버에서 실시간 유저 위치 정보를 맵 서버로 전송하며, 지도 상에 실시간 유저 위치를 표시할 뿐 아니라 통계 작성 기능을 수행한다. 다이나믹맵과 다르게 유저의 활동성 상태를 추적할 수 있어 마지막 이동 시점으로부터의 경과 시간을 계산하여 지도에 상태를 표시하는 기능이 있다.
개요
LILO는 서버 플러그인과 웹 지도 서버 사이에서 유저 위치 정보를 주기적으로 동기화하는 시스템이다. 플러그인은 플레이어의 월드, 좌표, 회전값, 게임모드 등 설정된 항목을 수집하여 지도 서버로 전송한다. 수신 서버는 이를 바탕으로 지도 상의 현재 위치 표시, 접속 상태 판정, 활동성 표시 등에 활용할 수 있다.
위치 정보는 일정 주기마다 전송되며, 설정에 따라 정지 중인 플레이어를 계속 전송하거나 일정 거리 이상 이동한 경우에만 전송하도록 조정할 수 있다. 또한 월드, 권한, 게임모드, 숨김 상태 등을 기준으로 추적 대상을 제한할 수 있다.
역사
LILO는 플레이시티 블록 지도에서 실시간 유저 위치를 표시하기 위해 도입되었다. 초기 버전은 플레이어 위치를 주기적으로 전송하고 접속 및 퇴장 상태를 알리는 기본 기능을 제공하였다. 이후 버전에서는 서버 운영 환경에서의 안정성, 설정 일관성, 전송 데이터 형식, 상태 진단 기능이 개선되었다.
2.2.0
2.2.0은 2026년 5월 21일 출시된 LILO v2 계열의 마이너 업데이트이다.[1] 이 버전은 실시간 위치 전송의 정확성과 운영 안정성을 개선하는 데 중점을 두었다.
이 버전에서는 설정으로 제외한 선택 필드가 기본값으로 전송되는 문제를 수정하고, 기존 설정 파일을 사용하는 서버에서도 기본 동작이 문서화된 설정과 일치하도록 정리하였다. 또한 추적 중이던 플레이어가 권한, 월드, 숨김 상태, 게임모드 등의 조건으로 더 이상 전송 대상이 아니게 된 경우 서버 측 상태가 오래 남지 않도록 오프라인 알림을 전송하도록 개선하였다.
실시간 위치 전송은 플레이어 UUID별 최신값을 우선하도록 조정되었으며, 서버 장애 시 오래된 위치 전송이 누적되지 않도록 재시도 정책과 회로 차단 방식이 보완되었다. 관리 명령어도 확장되어 `/lilo status`에서 HTTP 큐 상태, 실패 및 드롭 횟수, 회로 차단 상태 등 운영 진단 정보를 확인할 수 있으며, `/lilo test`는 API 연결 테스트 결과를 명령 실행자에게 직접 반환하도록 변경되었다.
| 버전 | 출시일 | 주요 변경 사항 |
|---|---|---|
| 2.2.0 | 2026년 5월 21일[2] | 선택 필드 직렬화 개선, 설정 기본값 정리, 추적 제외 상태 전이 처리, 실시간 위치 전송 안정화, 운영 진단 명령 강화 |
주요 기능
- 실시간 플레이어 위치 전송
- 월드, 권한, 게임모드 기반 추적 대상 필터링
- 정지 상태 전송 여부 및 최소 이동 거리 설정
- 접속, 퇴장, 서버 종료 시 상태 알림
- 웹 지도 서버와의 HTTP 기반 연동
- 운영 상태 확인 및 API 연결 테스트 명령 제공
설정 및 운영
LILO는 서버 환경에 따라 위치 전송 주기, 추적 대상 조건, 전송 항목, 운영 진단 기능을 조정할 수 있다. 운영 시에는 지도 서버와의 연동 상태를 주기적으로 확인하고, 버전 업데이트 후에는 기존 설정 파일과 새 기본 설정의 차이를 검토하는 것이 권장된다.
2.2.0부터는 기존 설정 파일에 새 항목이 누락된 경우 플러그인이 경고를 출력하며, 내장 기본값을 사용한다. 이 기능은 버전 업데이트 과정에서 설정 누락으로 인한 동작 차이를 줄이기 위한 것이다.