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, 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.1 adds: the Elevator Block, co-owner trust level, sub-sub-claims, Quick Run, Customize Menu, owner-controlled server-wide menu visibility, a reworked action log, pinned warps, mount carry on teleport, hologram limit raised to 100, and more.

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)".
4. Load in. Operators receive the Admin Tool automatically on first join.
5. The first admin to open the Admin Tool becomes the Owner.

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 seven 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

Permission Tiers

Admin Tools uses a four-tier permission system. Understanding these tiers is key to knowing who can do what on your server.

1. Player: All players. Can use the Player Tool to submit tickets, manage homes, use warps, TPA, deathback, view stats, and create land claims.
2. Moderator: Assigned by admins via Admin Tool → Players → [select player] → Actions → Assign as Moderator. Sees a limited "Moderator Panel" based on their privileges. Cannot be an operator.
3. Admin: Anyone with operator permissions (op level > 0), a player permission level above Member, or the admin tag. Admins can be assigned via Admin Tool → Players → [select player] → Actions → Make Admin. Admins have full access to the Admin Panel.
4. Owner: The first admin to open the Admin Tool. One owner at a time. Has exclusive abilities and protections like disabling the game mode button, clearing the admin log, ban/spy protection, and more.

Moderator Privileges

Moderator privileges are configurable both globally and per-individual moderator. Global defaults apply to all mods, but you can override specific permissions for each moderator individually.

Global defaults: Admin Tool → Control Panel → Config Editor → Mod Privileges

Per-moderator overrides: Admin Tool → Players → [select mod] → Actions → Manage Privileges

Enabled by default:

• Tickets
• Warn
• Kick
• Temp Ban (max 24 hours)
• Freeze
• Heal / Feed
• TP to Player
• Spy Camera
• View Inventory
• Punishment History

Disabled by default (admins can enable):

• Server Controls
• Ticket Settings
• Dimension Locks
• Config Editor
• Item Watch
• Commands
• Warps
• Broadcasts
• Summon
• Gamemode
• Admin Notes
• Rank Panel
• Rank Manager
• Clear Inventory
• Claim Bypass

Owner Menu Visibility

The server owner can hide optional top-level buttons from the Admin Tool main page server-wide. A hidden button disappears from every admin's main page, not just the owner's.

Separately, disabling a player-facing feature (Tickets, Warps, etc.) through the Config Editor now also hides that button from every player's Player Tool menu automatically. Previously the button stayed visible even when the feature was turned off.

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: Tickets/Warnings, Homes, Warps, TPA, Deathback, My Stats, and Info.

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).

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, max 20). 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.

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, summon, and dimension-lock ejection.

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 public warp. Warps show dimension icons so you know where you're going, and staff-only warps are hidden from regular players. Teleportation to locked dimensions is blocked. Mount carry applies here too (see Homes).

Warps can be pinned so they always appear at the top of the list. Pinned warps are useful for spawn or other frequently-used destinations. Both pinned and unpinned warps can be reordered within their respective groups.

Teleport

Path: Player Tool → Teleport

Send teleport requests 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 (see Homes).

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

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

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, void), you'll see a warning before teleporting.

The tool restore setting is now 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

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

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.

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.
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.

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.

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

Protections

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

Mob Blacklist: Specific mob types that are always removed when hostile mob protection is on. Configure at Claim Tool → Claims → 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.

Shulker box contents: Placing a shulker box inside a protected claim now returns its contents to the player's inventory rather than voiding them. Due to Bedrock limitations, contents are returned to the inventory rather than back into the shulker itself.

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.

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.

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.

Budgets & Chunks

Claim cost is measured in chunks (1 chunk = 16×16 = 256 blocks of XZ area). Despite the "Chunk" name, claims can be any size; cost is based on total block area.

• Starting budget: 5 chunks (configurable)
• Earned budget: +1 chunk per 60 minutes of playtime (configurable)
• Max budget cap: 15 chunks (default, before bonus)
• Bonus chunks: Admins can grant extra chunks to players at Claim Tool → Claims → All Claims / Settings → Add/Remove Chunks

Budget formula: min(start + earned + bonus, max + bonus). All budget and area settings are configurable at Claim Tool → Claims → All Claims / Settings → Claims Config.

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.

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.

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.

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, 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.

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 now an action form. From here you can Teleport directly to that home, Delete it, or close/go back. Previously this view was read-only.

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 to adjust distance, and crouch to stop. Each spy session is logged in the player's profile. Works on all platforms, including consoles and Realms.

Spy mode now 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.

Inventory Viewer

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

View a player's hotbar and armor slots. Ender chest contents are also available from the same screen: a snapshot is taken when the player opens their ender chest, then viewable via the Ender Chest button inside the Inventory Viewer.

Customize Menu

Path: Admin Tool → Customize

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.

Server Controls

Control Panel Overview

Path: Admin Tool → Control Panel

The Control Panel contains all server-level configuration. Sub-sections include: Config Editor, Item Watch, Ticket Settings, Dimension Locks, Server Controls, and Restore Holograms. Storage Health moved to the Action Log & Reports hub in v2.1.

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.
• 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.

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, tool restore toggle
• → Warn Flag Threshold: number of warnings before staff alert
• → Gamemode Access: owner only vs. all admins
• → AFK Settings: enable/disable, warn timer, kick timer, staff exemption
• → Mod Privileges: global defaults for all moderators

Item Watch

Path: Admin Tool → Control Panel → Item Watch

• Banned items: Automatically removed from player inventories on detection.
• Tracked items: Alert admins when a player holds more than the configured threshold.

Item Watch now keeps a persistent offline log of flagged item events. Staff can review events that fired while they were offline. The log lives under the Action Log & Reports hub alongside the other monitoring views.

Storage Health

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

Storage Health moved from the Control Panel to the Action Log & Reports hub, where it sits alongside other read-only monitoring views.

Monitors dynamic property storage usage across tickets, claims, the admin log, and the player registry. Automatic alerts appear on admin join when storage approaches capacity. You can also run an on-demand check from this view.

Current capacity limits:

• Claims: 3,000 (100 pages × 30 per page). Sub-claims and sub-sub-claims share this pool.
• Tickets: 500 (20 pages × 25 per page)
• Admin log: 800 (20 pages × 40 per page)
• Player registry: 500 players. Eviction warning threshold is at 450 (90%). When the limit is reached, the oldest entries by last-seen date are removed to make room.

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.

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.

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.

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.

Broadcasts & Logging

Broadcasts

Path: Admin Tool → Broadcasts

Send one-time multi-line announcements to all players, or set up scheduled recurring broadcasts (up to 5 active at a time).

Action Log

Path: Admin Tool → Admin Log

All moderation actions are logged with timestamps and staff names. Sub-views include Action Log, Rollcall (session join/leave log), Staff Activity (grouped by staff member), Storage Health, and Item Watch Log.

Entry format: Entries use bracketed italic timestamps, color-coded source tags ([ADM], [PLR], [SYS]), and blank lines between entries for readability.

PvP kills are now logged with the tag PVP_KILL, showing both the killer and victim names.

Filters: The three separate filter buttons (player, action type, source) were replaced with a single Filters button that opens a modal containing all three inputs. A Clear Filters button appears only when filters are active.

Clear Log: The owner-only Clear Action Log button moved from the log hub into the Action Log view itself, alongside Back and Close.

Silent eviction: When the oldest log entries roll off to make room for new ones, there is no longer a chat broadcast about it.

Rollcall and Staff Activity: Back and Close buttons now have icons consistent with the rest of the admin UI. No functional change.

Saved Commands

Path: Admin Tool → Commands

Save and run custom slash commands from a personal list. Each admin has their own command list (up to 50 saved commands).

Adding or editing a command now uses a single modal covering the name, command text, repeat toggle, and delay in one step. If the repeat toggle is on, a second step appears for repeat settings. The old three-step flow is gone.

Deleting a command is done from that command's detail page. There is no longer a separate Remove Command page with its own list.

One-shot commands with no delay now execute immediately when you tap Run. Previously they waited for the next scheduler tick.

Quick Run

Path: Admin Tool → Commands → Quick Run

Quick Run opens a single text field where you can type and run a command immediately. It does not save the command to your list, so it is useful for one-off commands that do not need to be kept. The action is logged in the Action Log like any other admin command.

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 (raised from 50 in v2.1). 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 add lines, adjust the position, preview, and place.

To edit an existing hologram, interact with it while holding the Hologram Tool. 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 new 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, and display height was reduced from 2 blocks to 1.

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 → AFK Settings

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.

Custom Commands

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

There's also a scriptevent for full data reset: /scriptevent jm_at:resetData

Troubleshooting & FAQ

"I don't see the Admin Tool in my inventory"

Make sure you're an operator on the world. Also check that both the behavior pack (BP) and resource pack (RP) are enabled and on the latest version (v2.1) in your world's Add-Ons settings.

"How do I change the owner?"

Use /jm_at:transferowner <player> to hand it to someone else, or /jm_at:resetowner to clear it so the next admin who opens the Admin Tool claims ownership.

"Achievements are still enabled, right?"

Yes. No experimental features or cheats are required for core functionality. Some slash commands do require cheats, but the addon's in-game menus (including gamemode changes) work without them.

"Can moderators perm ban?"

No. Moderators are capped at 24-hour temp bans by default. Admins control all moderator privileges.

"How do I reset everything?"

Run /scriptevent jm_at:resetData. You must run it twice within 10 seconds to confirm.

"Holograms disappeared"

Use Admin Tool → Control Panel → Restore Holograms to recover them.

"Storage is full"

Check Admin Tool → Admin Log → Storage Health. Consider deleting old tickets and clearing the admin log to free up space.

"An offline unban didn't take effect"

Offline unbans now reliably locate ban entries. World storage is synced immediately on ban and unban, so this should no longer occur. If you see a stale ban, try unbanning the player again through the Admin Tool.

"Claims aren't working"

Make sure both the behavior pack (BP) and resource pack (RP) are enabled and updated to the latest version (v2.1). Check that you have budget remaining; use the Claim Tool to see your current usage. If claims are set to admin-only by the server owner, regular players won't be able to create them.