JakesEssentials - StaffHelper Module v1.0.5 Update Notes

1. New Features & Updates

• X-Ray Detection System (/xray, /staffhelper xray, /jakesessentials staffhelper xray):

  • Ore Mining Tracking: Automatically monitors and tracks block break activity for configured valuable ores (e.g. Diamond Ores, Ancient Debris, Emerald Ores, Nether Gold Ore) in Survival and Adventure modes.
  • Strict Config Filtering: ONLY blocks explicitly registered in serverconfig/JakesEssentials/xray_config.json (monitoredBlocks) are tracked and logged; all other blocks are completely ignored.
  • Sliding Inactivity Window: Ore session tracking uses an inactivity timeout window (default: 30 minutes). Every break resets the inactivity countdown timer so that consecutive breaks within 30 minutes of each other remain part of the active mining session. If 30 minutes elapse without breaking that ore type, the session resets.
  • Staff Alerts: Broadcasts alert notifications to online staff with X-Ray permissions when a player breaks threshold (default: 4) blocks of a monitored ore type during an active session.
  • Per-Staff Alert Toggle: Staff members can independently enable or disable receiving X-Ray alerts for themselves using /staffhelper xray toggle (or /xray toggle). Toggle state is saved per staff member UUID.
  • Per-Ore 24-Hour Persistent Alert Retention: Evaluated independently per ore type. If alerts fire alertPersistenceTriggerCount (default: 3) times for a specific ore type during a session chain, that ore's break history is flagged as Persistent and stored on disk in serverconfig/JakesEssentials/xray_alerts.json for alertPersistenceHours (default: 24 hours).
  • Manual Inspection (/staffhelper xray check <player>): Allows staff to check the count of broken ores for online or offline players, displaying active session totals alongside 24-hour persistent alert histories.
  • Dynamic In-Game Configuration Commands:
    • /staffhelper xray add <block_id>: Adds a block ID to the monitored list and auto-saves config.
    • /staffhelper xray remove <block_id>: Removes a block ID from the monitored list and auto-saves config.
    • /staffhelper xray setthreshold <amount>: Sets the alert block count threshold (default: 4 blocks).
    • /staffhelper xray setwindow <minutes>: Sets the inactivity timeout window (default: 30 minutes).
    • /staffhelper xray setpersistencethreshold <count>: Sets the alert trigger count threshold per ore to activate persistent retention (default: 3).
    • /staffhelper xray setpersistencehours <hours>: Sets the retention duration for persistent alert records (default: 24 hours).

• Spectate Command (/spectate, /spec, /staffhelper spectate, /jakesessentials staffhelper spectate):

  • Quick Gamemode Toggle: Toggles the player between Spectator mode (GameType.SPECTATOR) and their previous game mode (Survival, Creative, etc.).
  • Game Mode State Restoration: Remembers the exact game mode the staff member was in prior to spectating, cleanly restoring it upon toggling spectate off.
  • Permission Node: Controlled via jakesessentials.staffhelper.spectate.
  • Config Option: Can be disabled in jakesessentials.toml via spectate = true under StaffHelper - DisabledCommands.

• Sudo Command (/sudo <player> <command/chat>, /staffhelper sudo <player> <command/chat>):

  • Force Execution: Allows authorized staff members to execute commands or send chat messages (c:<text>) as an online player.
  • Permission Node: jakesessentials.staffhelper.sudo (OP level 2 default).
  • Audit Logging: Logs all /sudo executions to daily audit log file.
  • Config Option: Can be disabled in jakesessentials.toml via sudo = true under StaffHelper - DisabledCommands.

• Enderchest Command (/enderchest, /ec, /echest, /staffhelper enderchest):

  • Direct Container Access: Opens the caller's personal Ender Chest container GUI directly via command.
  • Permission Node: jakesessentials.enderchest (OP level 2 default).
  • Configurable Cooldown: Supports enderchestCooldownSeconds (default: 0s) and .bypasscooldown permission.
  • Config Option: Can be disabled in jakesessentials.toml via enderchest = true under StaffHelper - DisabledCommands.

• Standardized Warmup & Cooldown Subsystem:

  • Supported Commands: /spawn, /warp, /playerwarp, /tpa, /home, /rtp, /feed, and /heal.
  • Action-Bar Countdown & Cancel: Teleportation warmups display an action-bar countdown. Moving (> 0.3 blocks) or taking damage cancels the warmup with a clear notification.
  • Conditional Cooldown: Cooldown timer is applied ONLY upon successful completion of a warmup or action. Cancelled warmups do not trigger a cooldown.
  • Bypass Permissions: Every command supports individual .bypasswarmup and .bypasscooldown permission nodes.

• Daily Audit Logger Subsystem (serverconfig/JakesEssentials/Logs/):

  • Automated Daily Log Files: Creates a daily log file formatted as YYYY-MM-DD.log inside serverconfig/JakesEssentials/Logs/.
  • Timestamped Action Formatting: Logs staff activities in the format [YYYY-MM-DD HH:mm:ss] UserName (UUID) - Action.
  • Action Logging: Automatically logs /spectate toggles and /sudo executions.
  • Configurable Retention Period: Added logRetentionDays (default: 2 days) in jakesessentials.toml. Files older than the retention period are automatically purged on server start and log rotation.

• Command Sequences & Sequence Scheduler (/sequence, /sequence schedule, /staffhelper sequence, /jakesessentials staffhelper sequence):

  • Timed Command Automation: Define automated command sequences saved as modular JSON files in config/JakesEssentials/sequences/*.json.
  • Sequence Step Types: Supports command steps (executes any server command string) and delay steps (delays execution for N seconds).
  • Interactive Chat Setup Wizard (/sequence setup <id>): Allows staff to build or edit sequences interactively in chat with clickable action buttons ([+ Add Command], [+ Add Delay], [✔ Save], [✖ Cancel]) and native Minecraft command auto-completion for command step inputs.
  • Sequence Editing: Running /sequence setup <id> on an existing sequence pre-populates all existing steps into the setup wizard for seamless editing without overwriting work.
  • Execution & Halt Commands: /sequence run <id> starts sequence execution (checks per-sequence permissions jakesessentials.sequence.run.<id>); /sequence stop [id] halts execution of a specific sequence or ALL active running sequences across the server.
  • Sequence Management: /sequence delete <id> deletes sequence JSON definitions from disk; /sequence list displays definitions and running instances; /sequence reload hot-reloads sequence JSONs.
  • Auto-Generated Sample Sequence: Automatically creates restart_5m.json on initial boot as a working sample template.
  • Multi-Format Quartz Cron Scheduler (/sequence schedule create/pause/resume/remove/list): Features a zero-dependency cron evaluator supporting 5-field (min hr dom month dow), 6-field (sec min hr dom month dow), and 7-field (sec min hr dom month dow year) Quartz cron syntax (e.g. 0 0/1 * 1/1 * ? *), ? wildcards, and A/B step syntax (0/1, 1/1).
  • Schedule Hover Tooltips: Hovering over schedule entries in /sequence schedule list displays formatted remaining time until the next trigger (Next run in: X Days Y Hours Z Mins W Seconds or PAUSED).
  • Pause & Resume Mechanics: /sequence schedule pause [id] stops scheduled triggers without clearing definitions or blocking manual execution. /sequence schedule resume [id] re-enables triggers.
  • Schedule Persistence: Automatically saves schedule configurations to config/JakesEssentials/schedules.json.
  • Dual-Layer Command & Help Integration: Fully accessible via /jakesessentials staffhelper sequence ..., /staffhelper sequence ..., and root /sequence ..., with complete entries added to /jakesessentials help.

2. Master Permission Nodes Added

3. Configuration Files Updated

• jakesessentials.toml:
  • Added warmup/cooldown settings for spawn, warp, home, tpa, rtp, feed, heal, enderchest.
  • Added logRetentionDays (default: 2) under StaffHelper - General.
  • Added spectate, sudo, enderchest, sequence (default: false) under StaffHelper - DisabledCommands.
• messages.toml:
  • Added configurable notification strings for sequence start/stop/delete, setup wizard prompts, and schedule creation/pause/resume/removal.
• config/JakesEssentials/sequences/*.json:
  • Modular sequence definition storage directory (auto-creates restart_5m.json).
• config/JakesEssentials/schedules.json:
  • Stores configured sequence schedules across server restarts.
• serverconfig/JakesEssentials/xray_config.json:
  • Automatically created on startup to configure monitored blocks, threshold, time window, and persistence settings.
• serverconfig/JakesEssentials/xray_alerts.json:
  • Stores 24-hour persistent alert records across server restarts.