RUNESTONE VALE

RunestoneAdminTool

The staff control nexus for RunestoneMMO — built to give admins cleaner, safer, menu-driven control over the realm.

RunestoneAdminTool is the administrative control module for the RunestoneMMO ecosystem. It provides the Admin Control Nexus, Admin Scepter, staff menus, selector workflows, confirmation screens, NPC authoring support, player management tools, system reload actions, and controlled world-access surfaces.

AdminTool is designed as an orchestration layer. That means it gives staff clean GUI workflows, but it does not duplicate backend authority. Economy actions still go through Core, NPC actions go through the live /rnpc bridge into RunestoneNPCs, world tools use WorldEdit/WorldGuard where appropriate, and module reloads call the proper module command paths.

In simple terms: RunestoneAdminTool is the staff-facing command center that helps manage Runestone Vale without forcing every task through raw commands.

View on Hangar Join the Discord Back to Runestone Vale

Platform: Minecraft Java Edition • Paper 1.21.11 • Java 21
Requires: RunestoneCore
Purpose: Staff/admin GUI workflows, tools, and safe command orchestration

What RunestoneAdminTool Owns

RunestoneAdminTool owns the staff-facing interface layer. It provides structured admin workflows while leaving real backend authority inside the correct modules.

Admin Control Nexus

The main staff menu used to access moderation, server management, player management, economy, system tools, and utilities.

Admin Scepter

A staff artifact used as a quick-access admin tool for opening and navigating administrative systems.

Selector Workflows

Provides player selectors, value selectors, block selectors, gamemode selectors, confirmation prompts, and chat-input flows.

NPC Admin Surface

Gives staff a unified surface for Citizens NPC actions and RunestoneNPCs-backed dialogue, quest, offer, and shop workflows.

Newest AdminTool Highlights

Recent AdminTool work has focused on safer staff workflows, NPC content authoring, online-only player inventory inspection, world access, WorldEdit wand support, and module reload surfaces.

World_Content Access

Staff can access the managed World_Content void world through AdminTool world access. This is intended for dungeons, boss arenas, quest rooms, raids, trials, and server content spaces.

WorldEdit Wand Button

AdminTool includes a WorldEdit wand button that runs the WorldEdit wand command path instead of spoofing a plain wooden axe. If WorldEdit is not enabled, it returns a clean error.

Online Inventory Inspection Only

Player inventory administration is now online-only. AdminTool no longer supports offline inventory editing, offline snapshot editing, or direct offline playerdata inventory mutation.

NPC Quest & Shop Workflows

AdminTool provides structured workflows for NPC selection, bindings, dialogue packages, quest packages, quest offers, quest rewards, NPC shops, shop settings, and listing management.

Module Reload Buttons

Server Management includes confirmation-gated reload actions for Core, Skills, Combat, AdminTool, Hub, and RunestoneNPCs.

Selector-First NPC UX

Quest, dialogue, offer, shop, skill, currency, and visibility workflows prefer existing valid selections first, with manual input available as a fallback.

Module Boundary

RunestoneAdminTool is powerful, but it is not the backend authority for every system it controls. Its role is to provide staff UI and safely route actions to the correct owner.

RunestoneAdminTool Owns

  • Admin Control Nexus menu
  • Admin Scepter item and listener
  • Staff menu workflows
  • Selector and confirmation flows
  • Chat-input prompt flows
  • AdminTool session state
  • Selected NPC context
  • Typed AdminToolAction runtime carrier
  • Wrapper execution orchestration
  • Admin-facing navigation and UX polish

Other Systems Own

  • RunestoneCore owns economy, claims, graves, resources, moderation, menus, world rules, and shared services.
  • RunestoneNPCs owns NPC bindings, dialogue, quests, quest state, rewards, and NPC shops.
  • Citizens owns NPC entity creation, selection, movement, and physical NPC identity.
  • WorldEdit owns region-editing commands and the real selection wand behavior.
  • WorldGuard owns region protection and region flag behavior.
  • RunestoneHub owns the player Hub UI runtime.
  • RunestoneCombat and RunestoneSkills own their own runtime/config reload behavior.

Main AdminTool Menus

Admin Nexus

  • Main entry menu for staff
  • Opened with /runestoneadmin, /ra, or /adminnexus
  • Resets transient flow state while preserving selected NPC context
  • Routes staff into major admin categories
  • Uses direct-coded menus rather than a YAML-driven admin framework

Moderation

  • Freeze player
  • Unfreeze player
  • Jail player
  • Unjail player
  • Temporary mute workflow
  • Vanish toggle
  • God mode toggle
  • Player/self selectors where appropriate

Server Management

  • Set day
  • Set night
  • Clear weather
  • Set rain
  • Set thunder
  • Broadcast message
  • Reload RunestoneCore
  • Reload RunestoneSkills
  • Reload RunestoneCombat
  • Reload Admin Nexus
  • Reload Login Hub
  • Reload RunestoneNPCs
  • Save world/player data

Player Management

  • Inspect Online Inventory
  • Teleport to player
  • Teleport player here
  • Teleport to world
  • Toggle flight
  • Heal player
  • Change gamemode
  • Online inventory administration only; no offline inventory editor

Economy

  • Give currency to a player
  • Take currency from a player
  • Set a player balance
  • Uses value selectors with presets and custom amount input
  • Routes to Core economy command/backend behavior

System Tools

  • Install Oraxen assets
  • Claims Admin
  • Graves Admin
  • NPC Admin
  • Hologram Admin
  • World Rules Admin
  • WorldEdit Admin
  • WorldGuard Admin

Admin Utilities

  • Spawn Admin Scepter
  • Spawn Hub Compass
  • Spawn WorldEdit Wand
  • WorldEdit wand uses WorldEdit command behavior
  • Returns clean error if WorldEdit is not enabled

Confirmation Menus

  • Used for dangerous or disruptive actions
  • Reload confirmation flows
  • Claim deletion confirmation
  • Protects staff from accidental destructive clicks

Player Management Contract

Player inventory administration inside AdminTool is intentionally limited to live online players. This protects playerdata files and avoids dangerous offline inventory mutation.

Live Inventory Support

  • Inspect online player inventory
  • Main inventory
  • Hotbar
  • Armor slots
  • Offhand slot
  • Online player selector only

Hard Prohibitions

  • No offline inventory editor
  • No offline snapshot editor
  • No offline save/cancel inventory workflow
  • No reading offline .dat player inventory files
  • No writing offline .dat player inventory files
  • No fallback from online inspection to offline storage

NPC Admin Suite

AdminTool’s NPC section is one of its largest staff systems. It brings together Citizens actions and RunestoneNPCs-backed /rnpc workflows into a cleaner admin interface.

Selected NPC Workflow

  • Create NPC
  • Select nearest NPC
  • Store selected NPC in AdminTool session state
  • Show selected NPC context in relevant menus
  • Teleport to selected NPC
  • Highlight selected NPC
  • Use selected NPC for follow-up binding and debug actions

Base NPC Actions

  • Bind NPC key
  • Unbind NPC
  • Debug NPC
  • View NPC metadata
  • Sync NPC metadata
  • Open NPC GUI
  • Reload NPC runtime through RunestoneNPCs

Dialogue Package Workflows

  • Browse existing dialogue packages
  • Create dialogue package
  • Delete dialogue package
  • Edit dialogue title
  • Edit NPC display name
  • Edit state-specific dialogue content
  • Inspect dialogue package info
  • Validate dialogue package
  • Bind dialogue to selected NPC
  • Unbind dialogue without clearing quest/shop bindings

Supported Dialogue States

  • offer
  • active
  • ready_to_turn_in
  • completed
  • Multi-page runtime content is backend-supported where configured
  • Advanced dialogue condition trees are not live

Quest Package Workflows

  • Browse existing quest packages
  • Create quest package
  • Delete quest package
  • Edit title, summary, objective, type, target, and amount
  • Capture discovery location
  • Set discovery radius
  • Inspect quest info
  • Validate quest package
  • Bind quest package as a modern NPC offer

Supported Quest Types

  • INVENTORY_ITEM
  • DELIVER_ITEM
  • KILL_MOB
  • INTERACT_NPC
  • DISCOVER_LOCATION
  • Trainer, travel, reputation, and complex branching quest systems are not live

Quest Offer Management

  • List NPC offers
  • Set offer quest
  • Remove offer
  • Set repeatable flag
  • Set daily flag
  • Set offer order
  • Enable offer
  • Disable offer
  • Set visibility to hidden or locked
  • Manage completed-quest prerequisites
  • Manage level requirements

Quest Reward Management

  • List quest rewards
  • Add currency reward
  • Remove currency reward
  • Add skill XP reward
  • Remove skill XP reward
  • Add item reward
  • Remove item reward
  • Set combat XP reward
  • Clear combat XP reward
  • Reward behavior remains owned by RunestoneNPCs runtime authority

NPC Shop Workflows

  • Create shop package
  • Select active shop key
  • Inspect selected shop context
  • Open authoritative shop editor
  • Preview selected shop
  • Bind shop to NPC
  • Unbind shop from NPC
  • Edit shop title
  • Edit shop mode
  • Edit buy/sell page titles
  • Edit buy/sell page sizes
  • Add held item listing
  • Remove listing
  • List shop entries

NPC Shop Modes

  • BUY_ONLY — players buy from the NPC
  • SELL_ONLY — players sell to the NPC
  • BUY_AND_SELL — NPC supports both buy and sell behavior
  • Valid shop sizes: 9, 18, 27, 36, 45, 54

World & Build Tools

AdminTool exposes staff-friendly access to build, world, and protection tools without replacing WorldEdit, WorldGuard, or Core’s world-rule authority.

World Selector

  • Teleport to loaded worlds
  • Access Devflat / creative_flat for staff build staging
  • Access World_Content for content building and testing
  • World_Content access is teleport-only
  • World_Content does not force Creative mode
  • World_Content does not enable flight

WorldEdit Admin

  • //set workflow
  • //replace workflow
  • //walls workflow
  • //outline workflow
  • Uses selector input for block choices
  • WorldEdit itself remains the authority for edit behavior

WorldGuard Admin

  • Region flag workflow
  • Region info workflow
  • Region teleport workflow
  • Region list/reference support
  • WorldGuard remains the authority for region behavior

World Rules Admin

  • World rule status
  • World rule info
  • World rule listing
  • World rule reload path
  • Routes to Core world-rule authority

Commands & Permissions

RunestoneAdminTool has a small command surface. Most functionality is accessed through the Admin Nexus GUI after opening the tool.

Main Command

  • /runestoneadmin — opens the Admin Control Nexus
  • /ra — alias
  • /adminnexus — alias

Subcommands

  • /runestoneadmin scepter — gives yourself the Admin Scepter
  • /runestoneadmin scepter <player> — gives an online player the Admin Scepter
  • /runestoneadmin reload — reloads the AdminTool system

Main Permission

  • runestone.admin
  • Default: OP
  • Grants access to RunestoneAdminTool and Admin Nexus
  • Includes online inventory inspection authority by default

Inventory Permission

  • runestone.admin.player.inventory.view
  • Default: OP
  • Allows viewing live online player inventories through AdminTool
  • Does not grant offline inventory editing because offline inventory editing is not supported

Configuration & Runtime Structure

RunestoneAdminTool is intentionally direct-coded for its menus and workflows. It does not use a large YAML-driven admin menu framework. This keeps the AdminTool aligned with real backend actions instead of fake buttons.

Important Files

  • plugin.yml — command and permission declaration
  • AdminTool.md — architecture and workflow contract documentation
  • AdminNexusMenu.java — main Admin Nexus menu
  • AdminToolWrapperExecutor.java — wrapper action routing
  • AdminToolFlowHandler.java — selector/chat-input flow handling
  • AdminToolSessionManager.java — transient session and selected context state

Architecture Guardrails

  • Direct-coded menu/runtime architecture remains required
  • No YAML/data-driven AdminTool framework reintroduction
  • AdminToolAction remains a typed runtime carrier
  • AdminTool must not duplicate NPC backend logic
  • AdminTool must not become a second persistence authority
  • Buttons must have real backend wiring

Why RunestoneAdminTool Matters

A growing MMO server needs more than raw commands. Staff need safer menus, clearer workflows, confirmation screens, selector-first input, and tools that reduce mistakes during live server management.

RunestoneAdminTool makes server administration more practical by turning many common admin actions into organized workflows. That matters for moderation, economy management, player support, NPC content creation, shop authoring, quest setup, build work, reload management, and world-content preparation.

The most important part is that AdminTool does this without stealing authority from the modules that own the actual systems. It is a staff control layer, not a second backend.

What Is Still Growing Inside RunestoneAdminTool

RunestoneAdminTool already provides a major staff control surface, but more polish and future workflow depth can still grow over time.

NPC Authoring Polish

Dialogue, quest, offer, reward, and shop workflows are live for the first-version scope, but more advanced narrative tooling can still grow later.

Player Quest Debug Views

Admin view of a player’s quest journal is planned so staff can better inspect hidden, unavailable, completed, and active quest truth.

Daily Quest Pool Editing

Per-player random NPC daily quest pools have backend support, but AdminTool pool editing UI is deferred beyond the first version.

More Staff UX Polish

Future work can continue reducing typing, improving selectors, and making staff workflows clearer without duplicating backend logic.

State of the Module

RunestoneAdminTool is actively serving as the staff control surface for Runestone Vale. It provides a direct GUI path into moderation, player support, economy tools, server management, world tools, NPC authoring, and system utilities.

The current module is strongest when used exactly as designed: staff use AdminTool for clean workflow access, while Core, NPCs, Citizens, WorldEdit, WorldGuard, Hub, Skills, Combat, and Stamina remain the true owners of their own systems.

This is the staff command center of RunestoneMMO — built to help admins manage a growing realm with less guesswork and fewer dangerous manual steps.

Open the Admin Nexus

RunestoneAdminTool gives staff a safer, cleaner way to manage Runestone Vale. Use the Admin Nexus for staff workflows, Admin Scepter access, NPC setup, system tools, world access, and live server support.

Open on Hangar See RunestoneCore View Server Features Join the Discord