Admin Overview

Admin Console

Navigate Sam’s systems from the left sidebar. The live panel keeps the same backend tools while using a cleaner dashboard-style layout for faster access.

Live Panel v5.24.49

Admin Control Build

Admin Console

Sam.py’s reorganized local control center for live runtime monitoring, player management, party coordination, encounter control, dice rolls, and diagnostics.

Players

0

Loaded in panel

Uptime

—

Sam session

Version

v5.24.49

Admin Panel v5.24.49

Status

—

Control center

Recent Runtime Changelog · v5.24.61

• v5.24.61 / Sam.py v1.8.06 / Fight v4.4.178: Made the full 13-slot equipment contract authoritative in runtime combat and live Character & Gear stats, fixed stale HP/MP sheet values after gear changes, made Admin Curse of Diablos edits synchronize every legacy meter field including exact 0%, and returned Licenses to an overhauled searchable list format.
• v5.24.59 / Sam.py v1.8.05 / Fight v4.4.177: Enforced DM/Admin-only equipped-item removal and replacement locks, repaired flat-schema stats, corrected Souleater, and restored Admin meter controls.

⚔

Fights

🛡

Gear

✦

GM Tools

System Overview

Loading...

Live Runtime

Gateway Latency

—

Guilds

—

Active Fights

—

Current Region

—

Items

—

Enemies

—

Sam Parties

—

Last Refresh

—

Selected Character

Character (per ID)

Active

—

Race

Character Region

Save Race / Region

Character Region is per-character. The global region remains available for world/admin systems.

Select a player on the left.

Actions Inventory License Audit Status Spells Teleport Network Economy

Quick Actions

HP Delta

-100-10+10+100

Apply HPFull HPKO

MP Delta

-100-10+10+100

Apply MPFull MPReset Both

Inventory

Item

Qty

Add Remove

Select a character to view inventory.

License / Inventory Audit

GM License / Inventory Audit

Cross-reference owned inventory against owned licenses. Green means the character owns and can use/equip it. Red means the item is owned but blocked by missing license data.

Live Admin Data

Search item / license

Category All Categories Weapons Armor / Helms Shields Accessories Scrolls / Magicks Consumables Other / Unknown

Blocked only Needs license

Refresh Audit Grant Missing

Inventory Cross-Reference

Reads every owned/equipped item, checks required licenses, and flags usability.

Select a character to audit inventory against owned licenses.

Green: licensed Red: missing license Blue: no license required Yellow: schema / unknown

Item	Qty	Required License	Missing	Status
No audit loaded.

Status / Effects

Effect / Status

Duration Permanent / Until Cured 30 seconds 1 minute 3 minutes 5 minutes 10 minutes 15 minutes 30 minutes 1 hour Custom seconds

Apply Remove Clear All

Permanent effects last until cured/removed. Timed effects expire automatically while DOT/HOT effects keep ticking.

Spells

Available Spell

Resource Controls

HP / MP controls are in Quick Actions

Cast Selected

Select a character to view usable spells.

Spells are generated from the character's license board and matching Scroll items in inventory.

Teleport Network

Location

Character Attunement · Tier 2+

Add AttunementRemove

Network Availability · Tier 3

EnableDisable

Select a character.

✦ Rare Item Rotation

Sam.py Rare Rotation v3 — inspect the active wave, tune cadence, force a new balanced wave, or stage a manual selection.

Wave Size

Rotation Hours

Automatic RotationEnabledPaused

Save Policy Force Balanced Rotation Clear Active Wave Refresh

Active Rare Items

Loading...

Manual Wave Candidate Preview

Select up to 12 eligible items. Manual activation replaces the current wave.

Activate Selected

Economy

Selected Character Gil Balance

—

Selected Character MGP Balance

—

Negative gil is treated as debt. Player-facing /pay remains positive-only and cannot be used to steal gil with negative transfers.

Projected after Gil Delta

—

XP Add (Sam-style)0

Apply XPReset

Gil Delta / Debt0

Apply GilReset

Use a negative delta here to create or increase debt. This is Admin Panel only.

MGP Delta0 MGP

Apply MGPReset

MGP cannot become negative and is never transferred through Gil payments or trades.

LP Delta0

Apply LPReset

XP uses Sam.py logic: XP → LP conversion, auto-levels, and full HP/MP restore on level-up.

Global Market Policy

Economy Update II

Refresh

Open the Economy workspace to load the current market, crafting, and gathering policy.

Sam.py Parties0 parties

All PartiesFull (6)Open Slots Refresh

Use selected Sam Party as the Raid Party source

Off: the manually assembled Raid Party overrides Sam.py parties. On: the selected persistent party is mirrored into Raid Party tools.

Region AssignmentCharacter / Persistent Party

Click a region to select it, then drag a character from the Players sidebar or drag an entire Sam.py Party onto the drop zone. You may also drop directly onto a region card.

Refresh Regions

Loading regions...

Choose a region first.

No region move performed yet.

Loading Sam.py parties...

Raid Party Drop Zone

Drag selected characters from the Players list into the raid. Max 10 player characters. Guest allies do not count against this cap.

Drop up to 10 player characters here.

Raid XP Distribution

Total XP To Split

0 / 10

Distribute XP CONFIRM Cancel Disband Party

No raid party assembled.

Raid Members

No members in raid party.

🩸 Allied NPC Engagements

Guest NPCs can resolve side-mission waves while the player party handles MSQ objectives.

Discord Channel: 1519476933430214727

Create Engagement

Mission Title

Selected Guests

0 / 6

Mission Request / Objective

Start Engagement Clear Guests Refresh

Guest Roster

Select up to 6 Guest NPCs from the existing Guest system.

Loading guests...

Active Engagement

Engagement

No engagement selected.

Build Enemy Wave

Pick up to 6 enemies for this wave. Each filled slot spawns one enemy, so mixed waves like Wolf / Skeleton / Bomb are supported.

Enemy Slot 1

Empty slot

Enemy Slot 2

Empty slot

Enemy Slot 3

Empty slot

Enemy Slot 4

Empty slot

Enemy Slot 5

Empty slot

Enemy Slot 6

Empty slot

Elite

0 / 6 enemies selected

Spawn Selected Wave Spawn Boss From Slot 1 Clear Wave Slots Run One Turn Complete Engagement End Engagement + Purge Channel

Purge removes messages from the NPC engagement Discord channel after ending the selected engagement.

Engagements

No engagements loaded.

Battlefield

Select an engagement to inspect guest and enemy state.

Recent Log

No log yet.

⚑ Warfront Command / Kingdom Conflict Simulator

Rebuilt from the old GM kingdom-war tools. Tracks territory forces, defensive garrisons, contested battlefields, Grimm defense plans, and simulated regional battles. Build: v5.24.39.

Loading war state...

⚔ Multi-Theater Campaign Command

Coordinate several allied factions across multiple fronts against Salem / the Grimm. Regional force tools below remain available for individual battles.

Campaign Layer

Campaign Name

ScaleRegionalContinentalWorld

Statusdraftstagedactiveresolvedcancelled

Phase

Supply %

Morale %

Allied Factions (Ctrl/Cmd-click for multiple)

Enemy Factions

Comma-separated. Defaults to Salem + Grimm.

Theaters / Locations (Ctrl/Cmd-click for multiple)

Strategic Objective

Command Notes

Save CampaignSimulate All FrontsNewDelete

Saved Campaigns

Loading campaigns...

Campaign Projection

Save a campaign, then simulate all selected fronts.

Kingdom Theater Overview

Regions

—

Contested

—

Garrisons

—

Deployments

—

Kingdom / Theater Loading kingdoms...

Select a kingdom to show location scrolls.

Use Selected + Left Attacker + Right Defender - Left Attacker - Right Defender

Pick a kingdom, then click a location scroll to inspect war state.

Battlefield Sides

Set up the selected location as a left-vs-right simulated fight: attackers/deployments on the left, defenders/garrisons on the right.

⬅ AttackersLeft Side / Deployments

Attacking Faction / Threat

Unit Type

Amount

Morale

Soldiers per Division

+ Add Attacker - Remove Attacker

Defenders ➡Right Side / Garrisons

Defending Faction / Kingdom

Unit Type

Amount

Morale

Soldiers per Division

+ Add Defender - Remove Defender

Division-style units can store soldiers/morale. Vehicles, aircraft, naval hulls, and strategic systems use simple counts.

⬅ Attackers / Deployments

Region	Faction	Unit	Count	Action
No deployments.

Defenders / Garrisons ➡

Region	Faction	Unit	Count	Action
No garrisons.

Operation / Grimm Defense / Battle Order

Plan Title

Plan TypeTerritory WarDefense from GrimmDefenseInvasionPatrolOther

Attacker / Threat

Defender

StatusDraftStagedActiveResolvedCancelled

Threat Level

Objective

Notes

Save Battle OrderClear Form

Simulated Battle Engine

Runs a regional force-vs-force simulation using deployed attack forces against defensive garrisons. This writes a battle report only; it does not alter Sam.py player combat.

⚔ Simulate Selected Location Sync Selected Location

No battle simulation report yet.

Active Plans

Plan	Region	Status	Action
No plans.

Loading live dungeon runs… The Admin Panel is connecting to Sam.py's persistent expedition service.

⚔️ Encounter Control

Enemies are filtered by current region unless Override Region Restrictions is enabled.

Region: Unknown

Active Fight

No active fight.

Region Control

Current Region

Unknown

Set Region

Set Refresh

Fight Controls Loading enemies...

Enemy

Variant / Level Auto / Default

Quantity

Channel ID

Select an enemy to preview its variant data.

End Note (optional)

Elite

Create / Add Enemy Refresh Enemies 🔔 Ping: ON Bypass: REGION Refresh Fight Mark Won Mark Lost Clear Fight

Only enemies in the current region or marked Global are listed.

Enemy list loading...

Textured Dice Roller

Difficulty Class

15

20

D20

Grab dice to roll

Click or drag the die • Sam.py Admin Dice

DieD20D10D100D1000

Rolls

Difficulty Class

Difficulty Tier

1 2 3 4

Tier presets default to DC 5 / 10 / 15 / 20. You can still type a custom DC.

Audio enabled Evaluate against DC

Roll DiceClear History

Audio files used by default: assets/sounds/dice_roll.ogg, success.ogg, failure.ogg.

Optional art overrides: assets/images/dice/d20_reference.png, difficulty_class_board.png, and result banner images. If absent, the UI falls back gracefully.

Roll Results

No rolls yet.

Latest Outcome

Waiting for a roll.

Audio Pack

Dice Roll / Success / Failure

Rare Rotation Command

Dedicated Rare Item Rotation control. The working Sam.py rotation engine and v5.24.79 controls are mounted here.

Runtime ConsoleDisconnected

PauseClear View

Auto-scroll

0 lineslogs/console_current.log

Stories Of Yggdrasil OSC

OSC Runtime Console

Live integration state is stored separately from players.json. Status/event history is written to the OSC JSONL console log.

Refresh

Loading OSC runtime…

Runtime Links

Loading…

Status / Combat Events

Loading…

Sync Requests

Loading…

Staff Approval QueueRefresh

Tier 1 requests appear here. Tier 2/3 staff can approve or deny them. Approvals write the reviewed after-state to players.json and emit an audit entry.

Refresh

Audit file rotates on bot restart: logs/audit_latest.jsonl

Flags

Read-only mode (blocks GM actions)
Enable GM actions
Override Region Restrictions for Fights
Ping RE-Notify when a new fight starts

Save Settings

Bestiary Staff View

Reveal the full Bestiary to eligible staff Player Panels
Viewing remains restricted to the configured Discord roles.

Apply Bestiary View

Info

—