Notice

Notice

Notice by PLAYCITY BLOCK

Simple by default

Notice makes recurring server announcements deliberately straightforward: place one JAR in plugins, start the server, edit plugins/Notice/config.yml, and run /notice reload. No database or web service is required. Notices can run in order or shuffle, broadcast only while players are online, use legacy or hex colors, and be sent immediately with /notice send.

Optional web-managed workflow

Notice does not include a web dashboard. If you are already comfortable with a web development stack, choose storage.method: mariadb or storage.method: postgresql and build your own authenticated admin interface on top of the selected database. Authorized staff can then create, edit, or remove notices from a browser wherever they are—without giving them Minecraft console or RCON access.

Notice keeps a validated in-memory snapshot instead of querying the database for every broadcast:

• /notice sync pulls the latest database state immediately.
• storage.mariadb.sync-interval-minutes or storage.postgresql.sync-interval-minutes controls automatic refresh. The default is 10; 0 disables scheduled synchronization; valid values range from 0 to 10080.
• interval is separate: it controls the announcement broadcast interval in seconds.

Database work runs asynchronously away from the server scheduling thread. A new snapshot is applied only after a complete, valid read; on failure, Notice keeps the last known-good runtime state. Keep database credentials in your backend, use a least-privilege account, and do not expose the database directly to browsers or the public internet.

Compatibility and features

One JAR supports Paper, Spigot, and Purpur 1.16.5 through 26.2, plus Folia 1.19.4 through 26.2. Representative Pufferfish and Leaf builds are also tested. Notice supports shared or per-notice prefixes, YAML-to-database migration with explicit confirmation for replacement, and Korean, English, Simplified Chinese, Japanese, and French administrator messages.

Requirements:

• Paper, Spigot, or Purpur 1.16.5 through 26.2; Folia 1.19.4 through 26.2
• Java 16 for 1.16.5, Java 17 for 1.17–1.19.4, Java 21 for 1.20–1.21.11, or Java 25 for 26.1+
• MariaDB/MySQL or PostgreSQL only when the corresponding database storage method is selected

Hot reload is not supported. Use a normal server restart when installing or replacing the plugin JAR.

한국어

기본 사용은 아주 간단합니다

Notice는 서버 공지를 어렵지 않게 운영하도록 만든 플러그인입니다. JAR 하나를 plugins에 넣고 서버를 시작한 뒤 plugins/Notice/config.yml을 수정하고 /notice reload를 실행하면 됩니다. 데이터베이스나 웹 서비스 없이 바로 사용할 수 있습니다. 공지를 순차 또는 무작위로 송출하고, 접속자가 있을 때만 동작하며, legacy·hex 색상과 /notice send 즉시 송출을 지원합니다.

웹에서 관리하고 싶다면

Notice에 웹 대시보드가 내장되어 있지는 않습니다. 하지만 웹 개발 스택에 익숙하다면 storage.method를 mariadb 또는 postgresql로 바꾸고, 선호하는 DB를 사용하는 인증된 관리 인터페이스를 직접 구축할 수 있습니다. 그러면 권한이 있는 운영자가 Minecraft 콘솔이나 RCON 권한 없이도 어디서나 브라우저로 공지를 추가·수정·삭제할 수 있습니다.

Notice는 매 송출마다 DB를 조회하지 않고 검증된 상태를 메모리에 유지합니다.

• /notice sync는 DB의 최신 상태를 즉시 불러옵니다.
• storage.mariadb.sync-interval-minutes 또는 storage.postgresql.sync-interval-minutes는 자동 동기화 주기입니다. 기본값은 10분이며, 0은 주기 동기화를 끕니다. 허용 범위는 0~10080분입니다.
• interval은 별도 설정으로, 공지 자체의 송출 간격을 초 단위로 지정합니다.

DB 작업은 서버 스케줄링 스레드 밖에서 비동기로 처리합니다. 완전하고 유효한 데이터를 읽었을 때만 실행 상태를 교체하며, 실패하면 마지막 정상 상태를 유지합니다. DB 비밀번호는 반드시 백엔드에만 보관하고 최소 권한 계정을 사용하며, DB를 브라우저나 공용 인터넷에 직접 노출하지 마세요.

호환성과 주요 기능

하나의 JAR로 Paper·Spigot·Purpur 1.16.526.2와 Folia 1.19.426.2를 지원합니다. Pufferfish와 Leaf의 대표 빌드도 검증했습니다. 공통·공지별 prefix, 확인 절차가 있는 YAML→DB 마이그레이션, 한국어·영어·중국어(간체)·일본어·프랑스어 관리자 메시지를 지원합니다.

Java는 선택한 서버 버전의 요구 사항을 따릅니다. 기준은 1.16.5에서 Java 16, 1.171.19.4에서 Java 17, 1.201.21.11에서 Java 21, 26.1 이상에서 Java 25입니다. MariaDB/MySQL 또는 PostgreSQL은 해당 DB 저장 방식을 선택할 때만 필요합니다. 핫 리로드는 지원하지 않습니다.