JakesEssentials - StaffHelper Module v1.0.0 Release Notes

Welcome to the initial release of the StaffHelper module for JakesEssentials (Minecraft 1.20.1 Forge). This module provides server administrators and moderators with a robust suite of tools for player moderation, punishment logging, inventory inspection, and configuration management.

1. Command Tree Structure

All commands are registered in three distinct formats for maximum compatibility and ease of use:

1. Direct Root Commands (e.g., /mute, /invsee)
2. StaffHelper Command Group (e.g., /staffhelper mute, /staffhelper invsee)
3. JakesEssentials Command Group (e.g., /jakesessentials staffhelper mute, /jakesessentials staffhelper invsee)

Commands Overview

2. Permissions System

The mod integrates with Forge's permission system (defaulting to level 2/admin for moderator commands).

Wildcard Permission Nodes

Wildcards are supported to allow easy group assignment via permission managers:

• command.jakesessentials.* - Grants access to all JakesEssentials commands.
• command.jakesessentials.staffhelper.* - Grants access to all StaffHelper module commands.

Specific Permission Nodes

• command.jakesessentials.staffhelper.mute: Allows muting players.
• command.jakesessentials.staffhelper.unmute: Allows unmuting players.
• command.jakesessentials.staffhelper.warn: Allows warning players.
• command.jakesessentials.staffhelper.playerinfo: Allows inspecting player data (both online and offline).
• command.jakesessentials.staffhelper.punishmenthistory: Allows viewing punishment history.
• command.jakesessentials.staffhelper.invsee: Allows viewing player inventories and armor.
• command.jakesessentials.staffhelper.invsee.edit: Allows editing/moving items inside /invsee containers. Without this, the view is read-only.
• command.jakesessentials.staffhelper.endersee: Allows viewing player Ender Chests.
• command.jakesessentials.staffhelper.endersee.edit: Allows editing/moving items inside /endersee containers. Without this, the view is read-only.
• command.jakesessentials.staffhelper.near: Allows using the /near command to check for nearby players.
• command.jakesessentials.staffhelper.vanish: Allows using /vanish to toggle admin invisibility.
• command.jakesessentials.staffhelper.freeze: Allows freezing and unfreezing players.
• command.jakesessentials.staffhelper.tempban: Allows temporarily banning players.
• command.jakesessentials.staffhelper.unban: Allows unbanning players.
• command.jakesessentials.staffhelper.ban: Allows permanently banning players.
• command.jakesessentials.staffhelper.kick: Allows kicking players.
• command.jakesessentials.reload: Allows reloading the mod configuration.
• command.jakesessentials.rules: Allows viewing server rules (granted to everyone by default).
• command.jakesessentials.debug: Allows executing JakesEssentials debug test commands (restricted to admins/ops).
• command.jakesessentials.spawn: Allows teleporting to spawn (granted to everyone by default).
• command.jakesessentials.spawn.others: Allows teleporting other players/selectors to spawn (restricted to admins/ops).
• command.jakesessentials.setspawn: Allows setting the server spawn point (restricted to admins/ops).
• command.jakesessentials.feed: Allows feeding self (restricted to admins/ops).
• command.jakesessentials.feed.others / command.jakesessentials.others: Allows feeding others and self (restricted to admins/ops).
• command.jakesessentials.heal: Allows healing self (restricted to admins/ops).
• command.jakesessentials.heal.others: Allows healing others and self (restricted to admins/ops).
• command.jakesessentials.fly: Allows toggling flight for self (restricted to admins/ops).
• command.jakesessentials.fly.others: Allows toggling flight for other online players (restricted to admins/ops).
• command.jakesessentials.fly.others.offline: Allows toggling flight for offline players (restricted to admins/ops).

3. Inventory & Ender Chest Inspection Safeguards

To prevent exploitation or bypasses during inventory viewing, the following systems have been implemented:

View-Only Protections (invsee / endersee without .edit permission)

• Slot-Level Interaction Block: The slots of the custom containers are dynamically replaced with overrides where mayPickup() and mayPlace() always return false.
• Click Interception: All click types (ClickType.PICKUP, ClickType.QUICK_MOVE (shift-click), ClickType.QUICK_CRAFT (drag distribution), etc.) are intercepted on the server side and canceled before being executed.
• Offhand Swap Protection (F key): Pressing the offhand swap key on container slots is completely blocked. When blocked, the server immediately forces a synchronization of both the chest container menu and the player's own inventoryMenu back to the client. This instantly reverts any "ghost items" on the client interface.
• Inventory Sorting Protection: Pick-all (canTakeItemForPickAll) is disabled, preventing automated client-side inventory-sorting mods from pulling items from the GUI.

Armor Inspection Slot Configuration

• In the /invsee {player} armor interface:
  • Slots 0-3 display the target's armor (Boots, Leggings, Chestplate, Helmet).
  • Slot 4 displays the target's Offhand item.
  • Slots 5-8 are filled with unnamed GRAY_STAINED_GLASS_PANE divider panes.
  • Divider slots 5-8 are completely locked and can never be interacted with or extracted, even if the moderator has edit permissions. Any items dropped into slots 5-8 are instantly deleted.

Ender Chest Multi-viewer Stability

• The target player's Ender Chest container is wrapped in a helper that overrides stillValid() to always return true.
• If the target player opens an Ender Chest block in-game and then walks away or closes it, the moderator's /endersee screen remains open and unaffected.

4. Configuration (jakesessentials.toml)

The configuration is saved in the server's config/JakesEssentials/jakesessentials.toml file.

[StaffHelper]
    # If true, muting a player will broadcast a message to the entire server. Default: true
    broadcastMutes = true
    # If true, warning a player will broadcast a message to the entire server. Default: false
    broadcastWarnings = false
    # If true, freezing/unfreezing a player will broadcast a message to the entire server. Default: true
    broadcastFreezes = true
    # If true, kicking a player will broadcast a message to the entire server. Default: true
    broadcastKicks = true
    # How long warning records are considered active/recent in hours. Default: 24
    warningDurationHours = 24
    # The default duration for freezes in hours if no duration is specified. Use -1 for infinite. Default: -1
    defaultFreezeDurationHours = -1

[StaffHelper - Bans]
    # If true, tempbanning a player will broadcast a message to the entire server. Default: true
    broadcastTempban = true
    # If true, permanently banning a player will broadcast a message to the entire server. Default: true
    broadcastBan = true

[StaffHelper - DisabledCommands]
    # If true, the /mute command will be disabled. Default: false
    mute = false
    # If true, the /warn command will be disabled. Default: false
    warn = false
    # If true, the /near command will be disabled. Default: false
    near = false
    # If true, the /vanish command will be disabled. Default: false
    vanish = false
    # If true, the /freeze and /unfreeze commands will be disabled. Default: false
    freeze = false
    # If true, the /tempban command will be disabled. Default: false
    tempban = false
    # If true, the /unban command will be disabled. Default: false
    unban = false
    # If true, the /ban command will be disabled. Default: false
    ban = false
    # If true, the /kick command will be disabled. Default: false
    kick = false

[General]
    # If true, new players will spawn at the setspawn point. Default: true
    spawnNewPlayersAtSpawn = true
    # If true, players with fly enabled who rejoin without permission will have their flight disabled. Default: false
    disableFlyOnJoinWithoutPermission = false
    # If true, a message will be broadcast when a player joins the server for the first time. Default: true
    enableFirstJoinMessage = true
    # The message to broadcast when a player joins for the first time. Use %player% for the player's name. Color codes supported via &. Default: &dWelcome &e%player% &dto the server!
    firstJoinMessage = "&dWelcome &e%player% &dto the server!"
    # If true, a custom message will be broadcast when a player joins the server. Default: true
    enableJoinMessage = true
    # The message to broadcast when a player joins. Use %player% for the player's name. Color codes supported via &. Default: &e%player% joined the game
    joinMessage = "&e%player% joined the game"
    # If true, a custom message will be broadcast when a player leaves the server. Default: true
    enableLeaveMessage = true
    # The message to broadcast when a player leaves. Use %player% for the player's name. Color codes supported via &. Default: &e%player% left the game
    leaveMessage = "&e%player% left the game"

[General - DisabledCommands]
    # If true, the /rules command will be disabled. Default: false
    rules = false
    # If true, the /spawn command will be disabled. Default: false
    spawn = false
    # If true, the /feed command will be disabled. Default: false
    feed = false
    # If true, the /heal command will be disabled. Default: false
    heal = false
    # If true, the /fly command will be disabled. Default: false
    fly = false