Admin Tools

Overview

Admin Tools is a complete in-game admin panel for Minecraft Bedrock servers and realms. It gives you full control over player moderation, ticketing, land claims, ranks, kits, teleportation, and server settings, all through clean in-game menus. No config files, no command memorization, no external tools.

Everything runs on the Script API with zero experimental features. Cheats stay off, achievements stay on. Whether you're running a small realm with friends or a larger server, Admin Tools takes care of the management side so you can focus on your world.

v2.2 adds: Kits, Gravestones, a live color-coded claim selection preview, Owner-Only claims, per-admin Admin Privileges, a Game Commands menu, hologram scoreboard and stat leaderboards, custom claim notifications, a central Menu Visibility panel, an editable Ender Chest, owner Reset commands, smarter search, and a lot of polish throughout.

Getting Started

Installation

1. Download the .mcaddon file from CurseForge.
2. Open it. Minecraft imports both the behavior pack and resource pack automatically.
3. Create or open a world → Add-Ons → Enable both "Admin Tools (BP)" and "Admin Tools (RP)". Enabling just one pack now pulls in its partner automatically, so activating only the behavior pack or only the resource pack still loads the other.
4. Load in. Operators receive the Admin Tool automatically on first join.
5. The first admin to open the Admin Tool becomes the Owner.

Updating from v2.1

Gravestones is on by default. This is a new feature, and it comes turned on (including on existing worlds) so deaths now leave a grave at the spot instead of scattering your items. Gravestones needs keepInventory, which the addon turns on and keeps on for you while gravestones is enabled. This does not disable achievements. If you'd rather have vanilla item drops back, turn gravestones off under Control Panel → Config Editor → Deathback.

Changing gamemode is now a staff privilege, and it's off by default. The old global gamemode toggle is gone. If your mods or admins used to switch gamemodes, re-grant it under Control Panel → Staff & Permissions (Mod Privileges / Admin Privileges).

Editing kits is its own privilege now. The new Manage Kits privilege is off by default, even for admins. The owner grants it to whoever should build kits. Players claiming kits is not affected by this. You can switch it on for all admins at once under Control Panel → Staff & Permissions → Admin Privileges.

Some new offline tools only appear after a player logs in once on v2.2. That covers editing a staff member's privileges while they're offline and viewing an offline player's homes. The button shows up once that player has joined again after the update.

First Launch

When you first load into a world with Admin Tools enabled, operators receive the Admin Tool and Player Tool automatically. All players receive the Player Tool on first join.

Use the Admin Tool to open the Admin Panel, and the Player Tool to open the Player Menu. These are your two main entry points, and everything in the addon branches out from these menus.

The resource pack includes a subpack option for button styling: choose between Default Buttons and Smooth Buttons in your world's resource pack settings. This changes the look of in-game form buttons.

Items & Recipes

Admin Tools adds eight custom items. All recipes are also viewable in-game through the Info pages on both the Admin Tool and Player Tool.

Elevator Block

The Elevator Block is a craftable block that lets players move vertically between floors without stairs or ladders. Jump while standing on a pad to go up; sneak while standing on a pad to go down.

Stack two or more pads in the same column and the block handles the rest. The maximum distance between pads is 128 blocks. If no pad is found within that range in the triggered direction, nothing happens.

Recipe: 4× Iron Ingot + Piston (shaped, diamond pattern). Also viewable in-game through the Info menus on both the Admin Tool and Player Tool.

No special claim rules apply. The Elevator Block breaks like any other block and respects claim protection. Players without build access cannot break or place pads inside a protected claim.

Roles & Permissions

Admin Tools uses a four-tier hierarchy. Each tier keeps everything the tier below it can do, so an admin can do anything a moderator can, and the owner can do anything an admin can.

Permission Tiers

Owner-exclusive powers. Some things only the Server Owner can do:

• Control Admin Privileges, decide what each admin is allowed to do (including who may change gamemodes).
• Create and manage Owner-Only claims, fully private claims no other admin or moderator can enter, build in, see, edit, expand, or delete.
• Run the reset commands, clearing a player's claims, clearing all claims, or restoring factory defaults.
• Set ban protection and spy protection for themselves (the owner can't be moderated).
• Clear the Admin Log.

The standalone gamemode toggle is gone in v2.2. Changing gamemodes is now a staff privilege (off by default) rather than a global on/off switch.

Staff privileges are managed under Admin Tool → Control Panel → Staff & Permissions.

The owner can also hide individual player-menu features (and some top-level admin buttons) under Menu Visibility, documented with the Server Controls.

Moderator Privileges

Moderators only see the parts of the Admin Panel they've been granted. Set the global defaults for all moderators at Admin Tool → Control Panel → Staff & Permissions → Mod Privileges (this moved out of the Config Editor in v2.2). Each privilege can also be overridden per moderator from their profile at Players → [mod] → Actions → Manage Privileges, online or offline.

On by default for moderators:

• Tickets
• Warn
• Kick
• Temp Ban (capped at 24h)
• Freeze
• Heal
• Feed
• TP to Player
• Spy Camera
• View Inventory
• Punishment History
• Teleport to Homes

Off by default for moderators:

• Claim Bypass
• Admin-Claim Bypass
• Server Controls
• Ticket Settings
• Dimension Locks
• Item Watch
• Config Editor
• Commands
• Game Commands
• Game Rules
• Warps
• Broadcasts
• Summon
• Gamemode
• Admin Notes
• Rank Panel
• Clear Inventory
• Rank Manager
• Manage Kits
• Admin Log & Reports

Admin Privileges

Server Owner only.

Admin Privileges work just like Mod Privileges, with both global defaults for all admins and per-admin overrides. Admins default to almost everything on. An unset privilege resolves to allowed. Only four things are off for admins until the owner grants them:

• Manage Kits
• Gamemode (changing gamemodes)
• Manage Roles (assign or remove staff)
• Edit Moderator Privileges

Admin Privileges also include Admin Claim Bypass, which decides who can enter other admins' personal claims. This does not affect normal “Admin claims”. Admins always have access to those. It is off by default.

Admins also hold powers moderators never get, such as Permanent Ban and Unban, which stay on by default.

Edit these at Admin Tool → Control Panel → Staff & Permissions → Admin Privileges, or override one admin from their profile at Players → [admin] → Actions → Manage Privileges.

Player Features

These features are available to all players through the Player Tool.

Player Tool Menu

Hold the Player Tool and use it (right-click / interact button) to open the Player Menu. The Player Tool can be crafted with Paper + Redstone (shaped, vertical) or is given automatically on first join.

The menu contains buttons for: Homes, Warps, Teleport (TPA), Deathback, Kits, Tickets/Warnings, My Stats, and Info. My Stats and Info are always shown; the rest are hidden when their feature is turned off.

As of v2.2, the server owner can show or hide most of these buttons in one place at Admin Tool → Control Panel → Menu Visibility. See Menu Visibility for details. Each feature's own on/off toggle still works and stays in sync with the Menu Visibility screen.

Tickets/Warnings

Submitting a ticket: Player Tool → Tickets/Warnings → Submit Ticket. Pick a category, describe the issue, and submit. Categories are configurable by admins at Admin Tool → Control Panel → Ticket Settings → Manage Categories.

There's a cooldown between submissions (default 2 minutes) and a maximum number of open tickets per player (default: 5). If your ticket is too short or the cooldown isn't up yet, you're told up front and the text you typed is kept rather than thrown away.

Ticket lifecycle:

1. Open: Ticket submitted, waiting for staff.
2. Claimed: A staff member has picked it up.
3. Resolved: Staff marked it as resolved.
4. Closed: Player viewed the resolution, ticket auto-closes.

Viewing warnings: Player Tool → Tickets/Warnings. View active warnings, acknowledge them, and submit appeals. Admins review appeals and can accept or deny them.

Homes

Path: Player Tool → Homes

Save locations as named home points, then teleport back to them anytime. Players can save up to a configurable number of homes (default 3). As of v2.2 the maximum you can allow per player has been raised to 50 (it was 20). Existing worlds keep their current setting, so raise it in your Homes settings if you want the higher cap. Each home can be assigned one of 11 color icons for organization.

You can also teleport to your bed spawn from the Homes menu. There's a short teleport delay (3 seconds by default but can be configured), and teleportation cancels if you move during the countdown.

The Update Home button on each home's detail view moves the saved home to your current location without deleting and recreating it.

Staff viewing player homes: Staff can view and teleport to a player's homes from that player's profile, including while the player is offline. The offline view is read-only (teleport only). An offline player's homes only become visible after they have logged in once on v2.2, so the addon can save a copy that works while they're away.

Who may open this home viewer is controlled by the Teleport to Homes privilege, which is on by default. Deleting a player's home is admin-only; moderators get view and teleport only.

Teleporting to a home brings your mount (horse, mule, camel, llama, pig, or strider) and nearby parrots along with you. This also applies to warps, TPA, and dimension-lock ejection. See the note below on mounts and dimensions.

Admins can enable or disable homes at Admin Tool → Control Panel → Config Editor → Homes.

Warps

Path: Player Tool → Warps

Server-wide teleport points created by admins at Admin Tool → Warps. Players can browse and teleport to any warp they're allowed to use. Warps show dimension icons so you know where you're going, and teleportation to locked dimensions is blocked. Mount carry applies here too (see Homes).

As of v2.2, warps have three visibility tiers:

• Public: visible to everyone.
• Staff-only: visible to admins and moderators.
• Admin-only (new): visible to admins only.

You set the tier when creating a warp, or change it later at Admin Tool → Warps → Set Visibility. Existing staff-only warps are unaffected by the update.

The warp limit was raised from 20 to 50, and long lists now page 25 at a time. Warps can still be pinned so they always appear at the top of the list, useful for spawn or other frequently-used destinations. Pinned warps can be reordered (moved up or down); unpinned warps are always listed alphabetically.

TP Player to Warp (new in v2.2): staff can send any online player to a warp without going there themselves. Find it at Admin Tool → Teleport → TP Player to Warp. It uses the same Summon permission as summoning a player.

Teleport

Path: Player Tool → Teleport

Send teleport requests (TPA) to other online players. Requests expire after 60 seconds. Both players must stay still during the teleport countdown; moving cancels the teleport. Mount carry applies here too, including the cross-dimension note under Homes.

The Last Location button inside the Teleport submenu sends you back to your most recent location before your last teleport.

The countdown cleanly cancels if the requesting player moves or disconnects. Previously there were edge cases where it could continue after they had left.

As of v2.2, closing the incoming request dialog with the X (or having the game close it for you) no longer counts as declining. The request simply stays pending. Only the Decline button declines it.

Admins can enable or disable this feature at Admin Tool → Control Panel → Config Editor → Teleport Settings.

Deathback

Path: Player Tool → Deathback

Return to the location where you last died. The addon tracks your death point automatically. If the death location is unsafe (lava, fire, or void), you'll see a warning before teleporting. As of v2.2 the unsafe-spot warning also flags a death where you burned to death after leaving the flames, not just a death while standing in fire.

The tool restore setting is a three-way option instead of a simple on/off toggle:

• Never: tools are never re-given on respawn
• Always: the Player Tool and Admin Tool are always re-given
• Only if held at death: tools are only re-given if you were holding them when you died

As of v2.2, tool restoration is also more reliable: re-giving is re-checked across a short window after you respawn, so tools land consistently and with no duplicates.

Configure at Admin Tool → Control Panel → Config Editor → Deathback.

Gravestones

When you die, your items go into a protected grave at the spot where you died instead of scattering on the ground. Walk up to the grave and interact with it to get your items back. Staff can recover a grave too.

Graves are protected: they can't be broken and they survive world restarts. Gravestones is on by default, including on existing worlds after updating to v2.2.

To turn Gravestones off and go back to vanilla item drops on death, use Admin Tool → Control Panel → Config Editor → Deathback. Turning it off there also hands control of keepInventory back to you.

Player Stats

Path: Player Tool → My Stats

Stats are tracked automatically for every player: playtime, mob kills, player kills, deaths, blocks mined, blocks placed, and distance traveled. Your stats are visible to you through "My Stats" and to admins through player profiles.

As of v2.2, these tracked stats can also drive hologram Stat Leaderboards, a hologram that ranks players by any of these stats. See Holograms for details.

Note: Stats are only tracked while the Admin Tools addon is enabled in the world.

Land Claims

Players and admins can claim and protect land using two items: the Claim Tool (select corners) and the Claim Viewer (see boundaries). Claims protect your builds from griefing with configurable protections. Everything is managed through in-game menus.

Creating Claims

1. Hold the Claim Tool.
2. Crouch + Hit a block to set Corner 1. In survival you no longer have to fully mine the block. The hit sets the corner instantly. (The old method of crouch-interacting on both blocks still works too.)
3. Crouch + Interact on a block to set Corner 2.
4. Open the Claim Tool (use it normally, without crouching) to open the Claims menu.
5. Tap Confirm Pending Claim.

The system auto-detects if your selection is inside, around, or bordering an existing claim and handles it accordingly.

In any claims list view (My Claims, Admin Claims, Browse All), a Current Claim button instantly selects the claim you are physically standing inside. This speeds up managing whichever claim you are currently in without having to scroll the list.

Live selection preview: As you set up a claim you can now see exactly what you are selecting before you commit. Temporary corner markers float at your two corners, and a live, color-coded outline draws the box you are selecting. Before you place Corner 2 the outline rubber-bands from Corner 1 to whatever block you are aiming at, snapping to it as you look around.

The outline color tells you what will happen if you confirm:

• Green: a normal claim, expand, or extend that will go through.
• Blue: a sub-claim inside an existing claim.
• Yellow: staff are overwriting an existing claim.
• Red: the selection is blocked.

When you set Corner 2, the action bar spells out the chunk size and the exact result, for example Ready to expand…, Overwriting will delete 2 claims, or the reason the selection is blocked. A blocked selection shows no Create button, so you never tap a button only to be rejected at the end.

The preview is on by default. Toggle it under Claim Settings (the live border preview option). If a stray selection gets left behind, tap Cancel Selection to clear it and its corner markers without relogging.

Claim Viewer

Hold the Claim Viewer in your offhand and the action bar will display info about the claim you're standing in. Crouch while holding it in either hand to show boundary particles in a 20-block range around you.

Holding the Claim Viewer also draws the same color-coded outline around nearby claims, so you can see their borders at a glance the same way the selection preview shows yours.

Boundary particles are only visible to you. Other players nearby do not see them.

Protections

Each claim has 13 individual protection toggles. Every protection is enabled by default on new claims except Eject Players and Allow Vehicles, which are both off by default. Admins set the default protections for new claims at Claim Tool → All Claims / Settings → Claim Defaults and control which protections players can toggle themselves at Claim Tool → All Claims / Settings → Player Abilities.

Mob Blacklist: Specific mob types that are always removed when hostile mob protection is on. Configure at Claim Tool → All Claims / Settings → Mob Blacklist.

Mob Whitelist: A global list of mob types that are allowed to spawn inside the claim even when hostile mob protection is enabled. Manage it through the claim's protection settings, or via command: /jm_at:mobwhitelist <add|remove|list> <entity_type_id>.

Container protection note: Breaking a container (chest, shulker box, barrel, furnace, etc.) inside a claim with container protection enabled is now blocked. Previously, the open-container check could be bypassed by breaking the block instead of opening it.

Fire Spread protection note: Fire spread protection no longer incorrectly extinguishes fires on netherrack, soul sand, or soul soil.

Hostile mob safe-list: Claim hostile mob protection now correctly leaves copper golems, nautiluses, happy ghasts, skeleton horses, and minecraft:sulfur_cube alone. If you maintain a manual mob whitelist, these types do not need to be included.

v2.2 protection fixes:

• Explosions shield entities too. With explosion protection on, armor stands, item frames, mobs, and players inside the claim no longer take blast damage, not just the blocks.
• Hostile fireballs are cleared. Ghast and blaze fireballs and evoker fangs are now removed inside a claim with hostile mob protection, just like the mobs themselves.
• No more ender pearl bypass. Ender pearls can no longer skip protection by landing on a mob or other entity inside the claim.
• Harmless thrown items are kept. Bottles o' enchanting, eyes of ender, chest boats, and similar harmless thrown items are no longer cleared in protected claims. Only genuinely harmful things still get removed.
• Shulker boxes return their contents. Placing a shulker box in an unowned or protected claim now returns the box and its contents to your inventory. (Due to Bedrock limits, contents come back into your inventory rather than the shulker itself.)
• Named pets are spared. A named pet (for example a named skeleton or zombie you keep in your base) is no longer swept up by the claim mob purge. The mob blacklist still removes a type even when it's named.
• Closed protection gaps. A few items that non-trusted players could still place or break (such as lit furnaces) are now properly protected.
• Creative duplication fixed. A creative-mode duplication exploit in claims with place protection has been closed.
• Crop trampling is more accurate. Running and jumping across a field no longer trample crops (previously it only caught jumping in place), and the cleanup no longer sweeps up nearby harvested item drops.
• Cleaner ejection. Players ejected from a claim are now placed outside the whole claim, including any extensions, so they can't get caught in a teleport loop on the edge.

Members & Trusted Ranks

Each claim has four member roles:

• Visitor: can enter the claim only
• Member: can interact with doors, buttons, and levers
• Builder: full access to build and interact
• Co-owner: full claim management permissions, can edit settings, manage members, and create sub-claims. Cannot delete the main claim itself.

Add individual members by name, with optional expiring access (15 minutes to 7 days). You can also grant access to everyone with a specific server rank at once using Trusted Ranks, each with a role and optional expiry.

Edit a member in place: the member screen (open it from the claim menu, or as an admin through Inspect → Members) now has an Edit button beside Remove. Use it to change someone's role or access duration without removing and re-adding them. Changing a role leaves a temporary member's expiry alone unless you set a new one.

Roles through ranks: Mod and Admin roles can also be granted through ranks (with a confirmation warning), and the /tag command grants the moderator role too.

Sub-Claims

Sub-claims are zones inside a parent claim with independent protections and member lists. You can have up to 10 sub-claims per claim. Create one by selecting an area inside an existing claim with the Claim Tool.

The claim hierarchy now supports three levels: a parent claim can contain sub-claims, and each sub-claim can contain sub-sub-claims. For example: a city claim can have district sub-claims, and each district can have individual house sub-sub-claims with their own protections and member lists.

The global claim limit pool is shared across all three levels, so parent claims, sub-claims, and sub-sub-claims all draw from the same total capacity.

Expanding & Extending

• Expand: Select a larger area that encompasses the existing claim to grow it.
• Extend: Select a bordering area to attach an extension (up to 2 per claim). Extensions share protections and members with the main claim.

Expanding an extended claim merges everything into one claim, resetting the extensions available.

Bonus claim chunks granted to an offline player now actually take effect when they log back in, rather than being lost.

Budgets & Chunks

Claim cost is measured in chunks, where one chunk is a 16×16 area (256 blocks of XZ surface). Despite the "chunk" name, claims can be any size and shape; the cost is based on the total block area you select, not on chunk grid lines.

• Starting area: 5 chunks by default (configurable). Admins can also start players at 0 area so they earn it as they play.
• Earned area: +1 chunk per 60 minutes of playtime (configurable).
• Max earned area: 15 chunks by default (before any bonus).
• Bonus chunks: Admins can grant extra chunks to players at Claim Tool → All Claims / Settings → Add/Remove Chunks. Bonus chunks raise the ceiling above the max earned area.
• Max claims per player: 5 by default. This is a separate cap on how many claims a single player can own, independent of how much area they have.

Area budget formula: min(start + earned + bonus, max + bonus), in chunks. All budget and area settings are configurable at Claim Tool → All Claims / Settings → Claims Config, where the screen now explains how claim size works and spells out the units.

Admin Claims

Admins can create server-owned protected areas that don't count against any player's budget. These are ideal for protecting spawn areas, shops, arenas, and other shared builds. Admin claims display the creating admin's name.

Admin claims are now strictly rank-based. A player whose Admin privilege is revoked no longer keeps creator access to admin claims they made. Access follows the rank, not the person who created it. A separate Admin Claim Bypass privilege controls who can enter other admins' claims (this does not change the shared, rank-based access to actual admin claims).

Transfer Ownership, Force Delete, Edit Protections, and Adjust Height are now available through every claim access path: My Claims, Admin Claims, and Browse All Claims. Previously some of these controls only appeared from certain paths.

Owner-Only Claims

Owner-Only claims (Server Owner only) are fully private claims that even other admins and mods cannot enter, build in, see, edit, expand, or delete. They are created and maintained exactly like a normal personal claim. Admins simply have no access to them at all.

Claim Notifications

Players get a short message when they cross a claim border, an "entered claim" notice when they walk in and a "left claim" notice when they walk out.

• Custom messages: write your own entered and left text at Claim Tool → All Claims / Settings → Claim Notifications. Placeholders like {owner} are filled in for you, and you can type \n for a line break.
• Where they show: choose the action bar, a center-screen title popup, or chat.
• Per-claim welcome message: a claim owner can set their own entry message for a single claim (open the claim → Welcome message). Admins can enable or disable this for everyone.
• Message delay: set how long to wait before showing the next notice (off, up to 5 seconds) so they don't spam when you cross borders quickly.

By default, claim notifications are enabled, shown on the action bar, with a 1.5-second cooldown, and the notice now appears in about 0.2 seconds.

Claim Log

The admin claim log was overhauled in v2.1. Entries now display as inline body text rather than one button per entry. Page size increased from 10 to 15 entries per page.

Event type labels now use a bracketed color-coded format, for example: [Member Added], [Deleted by Admin], [Transfer]. Claim expansions, extensions, and transfers previously had no label; they now have their own tags.

New filter controls let you narrow the log by player (type a name or pick from the registry dropdown) or by action type (dropdown of all event types). Active filters are shown inline. A Clear Filters button appears only when filters are applied.

Kits

Kits let staff build item bundles from their own inventory and hand them out to players. A kit can be an automatic starter kit (given on first join) or a claimable kit that players pick up themselves from a menu. Everything is built and managed in-game, with no commands or config files required.

Kits are enabled and visible by default, but no kits exist until you make one. You can have up to 30 kits, and each kit can hold up to 41 item entries (a full inventory plus armor and offhand).

Creating a Kit

Path: Kit Editor → Create Kit

A kit is built from your own current inventory. Toggle on the items you want to include, set the amount for each, and the kit stores a snapshot of those items. Custom names, lore, enchantments, and durability are kept where Bedrock allows it; some items (potions, written books, shulker boxes, leather armor, and similar) can only be given in a basic form and are flagged with a warning before you save.

1. Hold the Kit Tool and use it to open the Kit Editor, then tap Create Kit.
2. Pick an icon and give the kit a name (with an optional name color).
3. Toggle on the inventory items you want in the kit and set each amount.
4. Choose the type: Claimable (players pick it up) or Starter (auto-given on first join).
5. Set who can claim it, whether it is repeatable, and any playtime requirement, then save.

Who can claim a kit can be limited to:

• Everyone
• Staff only
• Admins only
• Mods only
• A specific rank
• A minimum playtime (a playtime rank, or a custom amount like 10h)

A claimable kit can be once-only (given a single time per player) or repeatable on a cooldown. Repeatable kits can also set a Max Total Claims per player, which caps how many times each player can ever claim that kit (blank or 0 means unlimited). Starter kits are always once-per-player and cannot have a playtime requirement.

Rank- or playtime-gated kits can either be hidden until a player unlocks them (the default) or shown grayed out. Starter kits have an extra option to also give the kit to existing players who never received it.

Claiming a Kit

Path: Player Tool → Kits

Players open Kits from the Player Tool menu to browse and claim available kits. Each kit shows a status line such as available, already claimed, claim limit reached, on cooldown, or the rank/playtime needed to unlock it. Selecting a kit shows its contents and a Claim Kit button.

Claiming needs enough free inventory space. If you do not have room, nothing is taken and you are asked to make space first; anything that still does not fit after a claim is dropped at your feet. Pinned kits appear at the top of the list with a star.

Give via Command

Path: Kit Editor → [click a kit] → Give via Command

Every kit comes with copy-ready commands so you can give or claim it from chat, an NPC button, or a command block. There are two script events:

• /scriptevent jm_at:givekit <kit>: hands the kit over directly, ignoring cooldowns, claim limits, rank, and playtime.
• /scriptevent jm_at:claimkit <kit>: claims the kit with the normal cooldown, limit, rank, and playtime rules applied.

<kit> can be the kit's name (color codes ignored) or #<id>. The kit goes to the player the command runs as, so you can target someone else with /execute as <player> run scriptevent jm_at:givekit <kit>, or wire it to an NPC or command block. The Give via Command screen generates these exact strings for you to copy.

Kit Editor Tools

Open the Kit Editor with the Kit Tool and click any kit to manage it. Available tools include:

• Edit Items: swap a kit's contents from your current inventory without rebuilding it. All other settings are kept.
• Give to Player: hand a kit to someone online right now, ignoring cooldowns and claim limits.
• Pin to Top: feature a kit at the top of the players' Kits list with a star.
• Reset Claims: clear one player's claim history for a kit, or wipe it for everyone.

The kit's page also lets you edit its settings (type, cooldown, limit, who can claim, visibility), change its icon, test the claim on yourself, and delete the kit.

Admin Panel

The Admin Panel is the central hub for server management. Open it with the Admin Tool. Top-level buttons include: Search, Tickets, Players, Teleport, Control Panel, Commands, Warps, Broadcasts, Admin Log, and Info. Moderators see a filtered version based on their privileges.

Tickets: Admin View

Path: Admin Tool → Tickets

View tickets across four tabs: Open, Claimed, Resolved, and Closed. Available actions include claiming a ticket, reply (add notes), resolve, close, teleport to the submission location, and delete (closed tickets only).

Ticket settings: Admin Tool → Control Panel → Ticket Settings. Toggle ticketing on/off, manage categories, set cooldowns and limits, and configure auto-delete after a set number of days.

Player Management

Path: Admin Tool → Players

Browse players in three views: Online players, Offline records, and Search by name. Select any player to open their profile and access moderation actions.

From an offline profile you can now do more than just read records. If the player is a staff member, a Manage Privileges button lets you edit their per-mod or per-admin privileges without waiting for them to log on (see Player Profiles). And if an offline player has any saved homes, a Homes button lets you view and teleport to them.

Player Profiles

Path: Admin Tool → Players → [select player]

Each player profile includes tabs for: View Tickets, Punishment History, Warnings (with appeals), Spy History, Admin Notes (up to 20 per player), and Rank. Player stats (playtime, kills, deaths, blocks, distance) are also visible here.

The admin home detail view on a player's profile is an action form. From here you can Teleport directly to that home, Delete it, or close/go back. Deleting a home is admin-only; moderators get view and teleport only.

You can also edit a staff member's privileges while they are offline. Open their offline profile at Admin Tool → Players → Offline → [select staff] → Manage Privileges and adjust their per-mod or per-admin overrides. No need to wait for them to be online. Admins can manage moderators (with the Edit Mod Privileges privilege); only the owner can manage other admins, and the owner is never editable. As with the other offline tools, the button appears after the staff member's first v2.2 login.

Actions & Moderation

From a player's profile, tap Actions to access moderation tools:

Spy Camera

Path: Admin Tool → Players → [select player] → Actions → Spy (Camera)

Silently orbit around a target player in spectator mode. Look around to orbit, walk forward/back to adjust distance, and crouch or jump to stop. Each spy session is logged in the player's profile. Works on all platforms, including consoles and Realms.

Spy mode uses spectator mode under the hood. This fixes held items showing incorrectly on the spied player and prevents potential save failures for enchanted items. The experience from the spying admin's perspective is unchanged.

Reviewing a player's Spy History (the log of past spy sessions on their profile) now requires the Spy Camera privilege, so it is only available to staff who are allowed to spy in the first place.

Inventory Viewer

Path: Admin Tool → Players → [select player] → Actions → View Inventory & Ender Chest

View a player's hotbar, inventory, armor, and offhand slots. The Ender Chest is now a live, editable view, just like the main inventory, so staff can take or remove items straight from it instead of only reading a snapshot. This replaces the old read-only ender chest view and needs the latest Minecraft version.

Customize Menu

Path: Admin Tool → Customize Menu

Each admin can customize which buttons appear on their own Admin Tool main page. Buttons you rarely use can be hidden, and sub-menu items buried one or two menus deep can be promoted as shortcuts directly onto the main page.

These changes only affect your own view of the Admin Tool. Other admins each manage their own layout independently. This is a per-admin preference for the Admin Tool and is separate from Menu Visibility, which is the owner-wide setting that controls which features appear in the Player Menu for everyone.

Server Controls

Control Panel Overview

Path: Admin Tool → Control Panel

The Control Panel holds all server-level configuration. Sub-sections include:

• Config Editor: homes, teleport, deathback, warn threshold, and AFK.
• Item Watch: auto-remove banned items or set threshold alerts on tracked items.
• Staff & Permissions: Mod Privileges, plus Admin Privileges for the owner. Mod Privileges, Admin Privileges, and Gamemode access all live here now.
• Menu Visibility: show or hide Player Menu features, and (owner only) hide optional admin-panel buttons.
• Ticket Settings: open/close ticketing, categories, cooldowns, limits, and auto-delete.
• Dimension Locks: toggle Nether/End access instantly, or schedule locks and unlocks.
• Server Controls: server lock and whitelist management.
• Restore Holograms: recover despawned hologram entities (admin only).

Storage Health lives under the Action Log & Reports hub, alongside the other read-only monitoring views.

Server Lock & Whitelist

Path: Admin Tool → Control Panel → Server Controls

• Server Lock: Prevents non-staff from joining the server. Toggle via the UI or with /jm_at:lockserver. Moderators can now join a locked server, so your staff are never shut out while a lock is active.
• Whitelist: Only approved players can connect (up to 200 players). Toggle via the UI or with /jm_at:whitelist.

Dimension Locks

Path: Admin Tool → Control Panel → Dimension Locks

Lock any dimension instantly, or schedule a lock with countdown announcements (5 min, 1 min, 30 sec). Players inside a locked dimension are sent to spawn. All teleportation to locked dimensions is blocked.

Menu Visibility

Path: Admin Tool → Control Panel → Menu Visibility

One screen to control what shows up in the menus. The owner can show or hide which Player Menu features appear server-wide (Homes, Teleport, Warps, Kits, Tickets, and more) and which optional top-level admin buttons appear on the admin panel.

Each feature's own enable/disable toggle stays in sync with this screen. Disabling a feature also hides its button, and turning a button off here is reflected on the feature's own toggle too, so the two never disagree.

Config Editor

Path: Admin Tool → Control Panel → Config Editor

All addon settings in one place. Changes take effect immediately, with no restart needed. Available sub-sections:

• → Homes: enable/disable, max homes per player.
• → Teleport Settings: enable/disable TPA, teleport delay.
• → Deathback: enable/disable, an Addon tools on respawn dropdown (no tools, tools in inventory only, or always give tools), and the Gravestones toggle (graves keep your items at the death spot).
• → Warn Flag Threshold: number of warnings before a staff alert.
• → AFK Settings: enable/disable, warn timer, kick timer, staff exemption.

Item Watch

Path: Admin Tool → Control Panel → Item Watch

Item Watch is split into three clear sections:

• Banned Items: Automatically removed from player inventories on detection. The list is fully editable and ships with sensible defaults.
• Tracked Items: Alert admins when a player holds at or above the configured threshold of an item. The alert fires once and resets when the count drops back below.
• Item Watch Log: A persistent log of flagged item events, so staff can review what fired while they were offline. You reach it from the third button on the Item Watch screen (Control Panel → Item Watch → Item Watch Log).

Storage Health

Path: Admin Tool → Admin Log → Storage Health (admin only)

Storage Health sits in the Action Log & Reports hub alongside the other read-only monitoring views. It tracks dynamic property storage usage across tickets, claims, the admin log, and the player registry. Automatic alerts appear on admin join when storage approaches capacity, and you can run an on-demand check from this view.

Storage Health now also reports the whole pack's real footprint, so you can keep an eye on overall storage on busy worlds.

Current capacity limits:

• Player registry: 1,500 players. The eviction warning appears at 1,350. When the limit is reached, the oldest entries by last-seen date are removed to make room.
• Claims: 9,000. Sub-claims and sub-sub-claims share this pool.
• Tickets: 500
• Admin log: 800

Ranks & Progression

Rank Database

Path: Admin Tool → Players → Rank Manager

Create up to 100 named ranks with custom colored name tags. Each rank has an internal name (up to 20 characters) and a display tag (up to 40 characters with Minecraft § color/style codes). Add, edit, and remove ranks from the Rank Manager.

Creating or editing a rank now shows a live preview of exactly how the name tag will look as you type, so you can see your colors and styles before you save. You can also use & in place of § when adding color codes by hand.

Bulk Assign / Remove

Path: Admin Tool → Players → Rank Manager → Bulk Assign / Bulk Remove

Assign a rank to many players at once (including offline players), or remove a rank from all or selected players.

Your selections are now kept as you move between pages, so a choice you make on one page is not lost when you flip to the next.

Staff Tags

Path: Admin Tool → Players → Rank Manager → Staff Rank Settings

Customize the default [Admin] and [Mod] name tags. You can also toggle per-staff custom rank display.

A new Hide staff ranks toggle stops the automatic [Admin]/[Mod] tag from showing above staff heads. A custom rank you have set for someone still shows. This is off by default.

Playtime Ranks

Path: Admin Tool → Players → Rank Manager → Playtime Ranks

Automatically promote players based on playtime thresholds (up to 20 tiers). Optionally override manually assigned ranks. Use the bonus playtime feature to credit untracked time to players who played before the addon was installed.

• The threshold text fields are hardened against bad or undefined input, so a mistyped value can no longer create a broken tier.
• Deleting a playtime threshold now asks you to confirm first, so you won't remove a tier by accident.
• The Bonus Playtime player list is now paged, so it loads fine on servers with a lot of registered players.
• Mod and Admin roles can be granted through ranks. Because that hands out staff powers, you get a confirmation warning before it takes effect.

Broadcasts & Logging

Broadcasts

Path: Admin Tool → Broadcasts

Broadcasts send a message to every active player. You can send one right away, or schedule a recurring one that fires on a set interval.

Sending or scheduling a broadcast is now a single screen with a live preview, so you see exactly how the message will look as you type. You can add color with & codes (for example &c for red or &6 for gold), and the older § codes still work too. A broadcast can have up to five lines; use Add line to reveal the next one.

• Send Immediate Broadcast: type your message and send it to everyone now.
• Add Scheduled Broadcast: set a Repeat every interval (for example 30s, 10m, or 6h) and an optional internal label, and it repeats on that interval.
• Manage Scheduled Broadcasts: pause, resume, edit, or delete any scheduled broadcast.

You can have up to 5 active scheduled broadcasts at a time. Intervals are shown exactly as you set them, so a 90-minute repeat reads as 90m rather than a rounded 1h. A mistyped interval is rejected with a clear message instead of being saved.

Game Commands

Path: Admin Tool → Commands → Game Commands

Game Commands is a quick, no-typing menu in the Commands panel for the common world settings you used to run by hand. Everything is a tap, and the menu only shows the options you are allowed to use.

• Weather: Clear, Rain, or Thunder.
• Time: Day, Night, Noon, or Midnight.
• Difficulty: Peaceful through Hard.
• World Spawn: set it where you stand, or go to it.
• Game Rules: toggle common world rules.
• Clear Dropped Items: remove ground item drops.

There is also a one-tap Gamemode switch that changes your own mode.

Two new staff privileges gate access, and both are off by default for moderators:

• Game Commands: covers Weather, Time, Difficulty, World Spawn, and Clear Dropped Items.
• Game Rules: covers the Game Rules picker.

The one-tap gamemode switch uses the existing Gamemode privilege. Grant any of these in Admin Tool → Control Panel → Staff & Permissions (Mod Privileges or Admin Privileges). A staff member who has none of these privileges won't see the Game Commands button at all.

Action Log

Path: Admin Tool → Admin Log

The Admin Log opens an Action Log & Reports hub with several views. Reading these logs needs the Admin Log & Reports privilege (off for moderators, on for admins by default).

• Action Log: a filterable record of admin and player actions.
• Rollcall: a session join/leave log for all players.
• Staff Activity: actions grouped per staff member.
• Storage Health: capacity monitoring (admin only).

Each Action Log entry shows the time, a source tag ([ADM] for admin/mod, [PLR] for a player, or [SYS] for a system event), who did it, the action, the target where one applies, and any extra detail. PvP kills are recorded too, logged as a player action (PVP_KILL).

• Filters: the Filters modal narrows the list by player, action type, and source (Admin / Mod, Player, or System).
• Clear Log: the server owner can clear the Action Log from the log view.
• The log keeps the most recent 800 entries. When it fills up, the oldest entries are quietly dropped to make room.

Saved Commands

Path: Admin Tool → Commands

The Commands panel lets you save up to 50 reusable commands. Use Add Command to create one on a single screen, and open a saved command to run, stop, edit, or delete it. Editing and deleting both happen from the command's own detail screen, and deleting asks you to confirm first.

A command can run once or repeat on an interval:

• Run once: with no delay set, activating the command runs it immediately.
• Repeating: turn on Repeating and set an interval. The repeat fields only appear once Repeating is on.

The old slider is gone. Instead, you pick how the repeat ends:

• Run forever (until you stop it),
• Run a set number of times, or
• Run for a set amount of time (a total runtime).

A plain-English recap of the schedule shows on the screen before you save, so you can confirm what the command will actually do. New commands start inactive. Turn one on from its page after saving to begin the run.

• Repeats now fire on the interval you set, down to 0.5 seconds.
• A mistyped or too-fast interval is rejected with a clear message instead of turning into a runaway fast loop.
• Moderators with the Commands privilege now have their scheduled commands fire too.

Quick Run

Path: Admin Tool → Commands → Quick Run

Quick Run is for a one-off command you don't want to save. Type the command (without the leading /) and run it once, immediately. It uses the same blocked-command rules as saved commands.

Holograms

Holograms are floating text displays placed in the world. This is an admin-only feature using the Hologram Tool (craft with Sign + Glow Ink Sac, shapeless).

A world can have up to 100 holograms total. Each hologram supports up to 10 lines with 60 characters per line. Minecraft color and style codes are fully supported. To create one, use the Hologram Tool on a block, then choose what kind of hologram you want:

• Text: custom lines of text you type in yourself.
• Scoreboard: a live leaderboard built from a scoreboard objective (see below).
• Stat Leaderboard: a live ranking of players by a stat the addon already tracks (see below).

After picking a type, add or configure your lines, adjust the position, preview, and place. The editor shows a live preview that updates as you change things.

Scoreboard holograms. A Scoreboard hologram shows the top entries of a scoreboard objective and refreshes itself about every 10 seconds, so the standings stay current without you touching it. Pick or create the objective when you make the hologram. By default a scoreboard hologram:

• shows the top 10 entries,
• sorts high to low (descending),
• includes offline players, and
• formats each row like rank. name - score.

You can change the title, how many rows show, the row format, the sort direction, whether offline players appear, and whether scores use comma separators while editing the hologram.

Stat Leaderboard holograms. A Stat Leaderboard hologram ranks players by stats the addon already tracks. No scoreboard setup and no typing. Pick Stat Leaderboard when creating the hologram and choose the stat; the addon builds and keeps the leaderboard up to date for you, refreshing itself about every 10 seconds just like a scoreboard hologram. You can rank players by any of these tracked stats:

• Playtime
• Player kills
• Mob kills
• Deaths
• Blocks mined
• Blocks placed
• Distance traveled

To edit an existing hologram, sneak and interact with it while holding the Hologram Tool. Add colors and styles by typing & color codes (for example &c for red or &6 for gold) into the text fields; the classic § codes still work too, and the live preview shows exactly how your text will look. If holograms despawn (for example, after a world reload), restore them at Admin Tool → Control Panel → Restore Holograms.

Holograms placed in v2.1 or later use a half-block (0.5) entity height (jm_at:hologram_v2), which improves placement against ceilings and overhangs. Holograms placed in earlier versions keep their original 1-block height and are not affected by this change. General placement edge cases have also been improved.

Chest Sorter

Craftable by all players. Use the Chest Sorter item on any vanilla chest, trapped chest, copper chest, barrel, or shulker box to sort its contents alphabetically. Recipe: Iron Ingot + Chest + Iron Ingot (shaped, vertical).

AFK Detection

Settings path: Admin Tool → Control Panel → Config Editor (the AFK section)

Configurable idle detection with a warning timer (default 2 minutes idle) and an optional auto-kick timer (disabled by default; 60 minutes when enabled, configurable from 10 to 120 minutes). Staff can be exempted globally.

AFK players see cycling subtitle reminders. Moving, looking around, or interacting with anything resets the timer.

As of v2.2, the idle check also counts more kinds of activity. Using an item (eating, fishing, or drawing a bow) and interacting with an entity (such as trading with a villager) now reset the timer, so an active player who is standing still is no longer kicked for being idle.

Custom Commands

Admin Tools registers custom slash commands for quick access to key features:

Reset Script Events

A few /scriptevent commands let the Server Owner wipe or reset addon data. These are Server-Owner only. An op or command block can run /scriptevent, but the addon still checks that you are the owner before doing anything.

The two server-wide claim and settings resets (resetAllClaims and resetToDefaults) ask you to run the same command again within 10 seconds to confirm, so a fat-finger can't wipe anything. resetPlayerClaims runs on the first command since it only affects one player.

Troubleshooting & FAQ

Most issues come down to permissions, a feature being turned off, or running an older build. Work through the questions below before reaching out. They cover the things people ask about most.

The Admin Tool does nothing / I have no admin powers.

The first admin to open the Admin Tool becomes the server owner. If you have no powers, you are not recognized as staff yet. An operator, a player permission above Member, the admin tag, or a rank named or tagged Admin all grant admin access. A moderator is set the same way with the mod/moderator tag, a Moderator rank, or Players → (open the player) → Assign as Moderator.

A button or feature is missing from my menu.

Two things hide menu entries. First, your privileges: many tools are gated and default off for moderators (and a few for admins). The owner grants them under Admin Tool → Control Panel → Staff & Permissions. Second, Menu Visibility: the owner can hide player-menu features and optional admin-panel buttons under Control Panel → Menu Visibility. If a player feature is missing, check both its own setting and the Menu Visibility toggle. The two stay in sync.

I am stuck in Spectator (cheats off).

Press Sneak + Jump together to open a rescue menu that lets you switch back to Survival or Adventure (Creative too, if you have the gamemode privilege), or keep working from your tools without leaving Spectator. If you rejoin the world while still stuck, the menu reopens for you automatically. This works without cheats or operator status, so you can always get out.

I can't read why something was rejected.

As of v2.2, errors show as a popup you dismiss with OK, instead of flashing past in chat (which is hidden while a menu is open). That way you can actually read why an action was refused. Success messages still go to chat as before.

My teleport (TPA) request keeps getting declined.

Closing the request dialog with the X (or having the game close it for you) no longer counts as declining. The request just stays pending; only the Decline button declines it.

My mount didn't come with me when I teleported.

Mount teleporting is more reliable now, and a prompt lets you leave your mount behind if you prefer. Mounts can't follow you across dimensions (a Minecraft limitation), so a teleport to another dimension leaves your mount safe and alive where it was and takes you on your own.

Items keep disappearing in my claim.

Harmless thrown items (bottles o' enchanting, eyes of ender, chest boats, and a few others) are no longer cleared inside protected claims. Things that actually hurt you, like hostile mobs and their fireballs, are still removed when the matching protection is on. If a named pet is being cleared, note that a name tag spares a mob from the purge unless its type is on the mob blacklist.

Deaths scatter items / a grave appeared instead.

Gravestones is a new v2.2 feature and is on by default, so deaths now leave a protected grave at the spot. Walk up and interact to recover your items (staff can recover any grave). It needs the keepInventory game rule, which the addon turns on and keeps on for you while it is enabled (this does not disable achievements). To go back to vanilla drops, turn Gravestones off under Control Panel → Config Editor (the Deathback section).

My mods or admins can't change gamemode anymore.

Changing gamemode is now a staff privilege, and it is off by default. Re-grant it under Control Panel → Staff & Permissions (Mod Privileges or Admin Privileges). The old global gamemode toggle is gone.

An offline tool button isn't showing up.

Some v2.2 offline tools (editing a staff member's privileges while they're offline, and viewing an offline player's homes) only appear after that player has logged in once on this version. The button shows up after their first login post-update.

How do I reset everything?

There are two different resets, run by the Server Owner as /scriptevent commands:

• jm_at:resetToDefaults: settings only. Puts every setting back to factory defaults without touching your claims, players, ranks, tickets, bans, holograms, or kits.
• jm_at:resetData: a full wipe. Permanently deletes all addon data: settings, claims, tickets, ranks, everything.

Both ask you to run the same command again within 10 seconds to confirm, so a mistype can't wipe anything. If you only need to fix your configuration, use resetToDefaults and keep your data.

I'm hitting a storage or capacity warning.

The addon stores up to 1500 recent players in the registry and up to 9000 claims, and warns as you approach those limits. Check Admin Tool → Admin Log → Storage Health to see the whole pack's real footprint and where the space is going.