JP Plugins
All plugins

JPEvents

Automatic server events - contests, King of the Hill, drop parties and treasure hunts.

Gameplay plugin, version 1.0.0

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

  1. Put JPEvents-<version>.jar in your server's plugins folder.
  2. Restart the server. plugins/JPEvents/ is created with the config and messages.
  3. 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

CommandDescriptionPermission
/event [info|top|start|stop|list|setlocation|reload]
Aliases: /events, /jpevents
See or run server events.jpevents.use

Permissions

PermissionDefaultDescription
jpevents.useeveryone/event and /event top.
jpevents.adminoperatorsStart, 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_LEVELUP

Support

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.