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.1.3-session-rekey-auth shell redesign

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.1.3-session-rekey-auth

Admin Panel 5.1.2

Status

—

Control center

v5.1.3-session-rekey-auth

• Full HP / Full MP now restore to effective Augment-aware caps instead of raw stored max values.
• Fight panel enemy labels now mirror Final Fantasy duplicate lettering: Dire Rat A, Dire Rat B, Set A, Set B.
• Fight controls were reorganized into cleaner Command, Enemy Forces, Guest Allies, and Encounter Overview modules.
• Dashboard anti-flicker guards were preserved and expanded around live runtime refreshes.
• Reorganized dashboard, fights, and console layouts.
• Live dashboard metrics now update only when values change, preventing flicker and duplicate counter flashes.
• Added animated D20, D10, D100, and D1000 rolls with optional local audio.
• Added Sam.py persistent-party browser and filters, kept separate from temporary Raid Parties.
• Raid Parties can optionally mirror a selected Sam Party; manual Raid Parties remain the default override.
• Combined HP and MP controls into one resource-management section.
• Added SOY storefront-inspired color themes for every major panel.
• Raid Parties now allow 10 player characters while keeping Guest allies excluded from the cap.
• Added NPC Engagements for autonomous Guest side-missions in the dedicated engagement channel.
• Improved console filtering, auto-scroll, connection state, and readability.

⚔

Fights

🛡

Gear

✦

GM Tools

System Overview

Loading...

Live Runtime

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

Economy

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

LP Delta0

Apply LPReset

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

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.

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.1.3-session-rekey-auth.

Loading war state...

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.

⚔️ 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

Runtime ConsoleDisconnected

PauseClear View

Auto-scroll

0 lineslogs/console_current.log

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

Info

—