JPEvents
Automatic server events - contests, King of the Hill, drop parties and treasure hunts.
Downloads open soon.
Features
- Automatic server events on a schedule
- Mining, fishing, monster hunt and builder contests, King of the Hill, drop parties and treasure hunts
- Live scores and rewards for the winners
- Start, stop and place events with
/event
Requirements
- Paper 26.1 or newer (Java 25)
- Optional:
- Vault: money (any Vault economy)
Installation
- Put
JPEvents-<version>.jarin your server'spluginsfolder. - Restart the server.
plugins/JPEvents/is created with the config and messages. - Change what you want in the files, then reload or restart.
Type /jp as an operator to see every JP plugin you have installed, its version and which optional plugins it found.
Commands
| Command | Description | Permission |
|---|---|---|
/event [info|top|start|stop|list|setlocation|reload]Aliases: /events, /jpevents | See or run server events. | jpevents.use |
Permissions
| Permission | Default | Description |
|---|---|---|
jpevents.use | everyone | /event and /event top. |
jpevents.admin | operators | Start, stop and set up events. |
Configuration
All files are in plugins/JPEvents/. Files: config.yml, events.yml, messages.yml.
When you update the plugin, new options are added to your config.yml by themselves, with their comments. Your own settings stay as they are, and the old file is kept as config.old-v<number>.yml.
Languages: English, Spanish, Portuguese, French and German. Set language: in config.yml (en, es, pt, fr or de).
Default config.yml
# Used to add new options to this file after an update. Don't change it.
config-version: 1
# ╔══════════════════════════════════════════════════════════════════╗
# ║ JPEvents · config.yml ║
# ╚══════════════════════════════════════════════════════════════════╝
# Server events that start by themselves: mining/fishing/monster contests, King of the
# Hill, drop parties and treasure hunts. The events are in events.yml.
# Apply changes with /event reload.
#
# Setting up (as op):
# /event setlocation koth stand on the hill to set it
# /event setlocation drop-party where the items rain down
# /event setlocation treasure (optional) centre of the treasure search area
# /event start mining start one now /event stop
# /event list every event, and which still need a location
# Players: /event (what is running) and /event top (scores).
# Language of the messages: en (messages.yml), es, pt, fr or de (lang/<code>.yml).
# Your own language: copy a file in the lang folder to lang/<code>.yml, translate it
# and set its code here (for example it for lang/it.yml).
language: en
# Replace messages.yml with the new design when the plugin is updated.
# Your old file is kept as messages.old-vX.yml. false = never touch it.
auto-update-style: true
schedule:
enabled: true
# Start a random event this often (minutes). Events with weight 0 are never picked.
every-minutes: 60
# Fixed times (24h): "HH:mm": event id or random.
times:
'20:00': random
treasure:
# Hints show the treasure's coordinates rounded to this many blocks.
hint-rounding: 50
# Items put in the treasure chest (picked from the event's loot list).
items: 6
sounds:
start: UI_TOAST_CHALLENGE_COMPLETE
end: ENTITY_PLAYER_LEVELUPSupport
Guides and the docs of every JP plugin are on the JP Plugins website. Questions, bugs or ideas? Join the JP Plugins Discord.
License
JPEvents is free to use on any server, including servers that make money, but it is not open source. Don't reupload, sell or share modified copies of it. The full terms are in LICENSE.txt, which is also inside the jar.