.yash.is.here.
πŸ“Ž 1 file 19,165 chars
πŸ“„
TEACHING-SERVER-PLUGIN-PROMPT.md
md 378 lines
β–Ά
# TEACHING SERVER β€” BUILD FROM SCRATCH
## This document is the ONLY source of truth.

**DO NOT ask for teaching-server-core.sk.**  
**DO NOT wait for an original file.**  
**DO NOT say you need the Skript as a logic oracle.**  
If this spec is in the prompt, you already have the product. Write Java from **this file only**.

You are writing a new Paper 1.21.11 plugin named `TeachingServer` (Java 21).  
A Skript used to exist. It is **retired**. Re-implement the behavior described below. Reasonable defaults are listed. If a tiny detail is missing, pick the obvious survival-server default and keep going.

Maker credit (keep): `/xyash` `/about` β€” Yash β€” `.yash.is.here.`

Soft depend only: PlaceholderAPI, LuckPerms, PacketEvents.  
Do not require: DeluxeMenus, Vault, CoordinateOffset, Essentials.

If the JAR is a 30KB stub with empty GUIs, you failed. Ship working modules, not a readme inside a jar.

---

---

# A. HARD RULES

1. Implement **every command listed in section D**. Missing `/orders` or `/editshop` = fail.
2. Implement **every GUI in section E** with the slot maps given. Empty 9-slot dummy menus = fail.
3. Economy, shop catalog, AH listings, orders, homes, teams, bans, settings persist in `plugins/TeachingServer/data/` with **30s dirty flush** + save on disable.
4. All player text in `messages.yml`. All numbers/toggles in `config.yml`. `/apanel` writes config values. `/epanel` writes feature booleans.
5. GUIs use custom `InventoryHolder`. Display menus cancel click, drag, number-key, clone, drop. Filler items carry PDC `teachingserver:btn`. Steal glass = fail.
6. Lore is `List` (one fact per line). Never `"a||b"` as a single lore string.
7. **Brigadier tab** on every command that has subcommands. `/eco` + Tab must show `give`, `take`, `set`, `reset`. Same idea for `/team`, `/ah`, `/gchat`, `/keyall`, `/ss`, `/warp`, `/modword`, `/chatsettings`, `/flyspeed`, `/clearlag`, `/xray`, `/cg`, `/orders`, `/auth`, `/afk`, `/punish`.
8. Empty command with no args prints **help** (not silence). Exceptions: `/shop` `/ah` `/orders` `/team` `/settings` `/apanel` `/epanel` `/home` `/baltop` `/sell` `/editshop` `/keyall` `/bounty` `/mod` `/chatcolor` `/rules` `/discord` `/stats` `/media` `/opreports` `/monitor` `/chatsettings` open GUIs.
9. Do not log `/login` `/register` `/changepass` raw arguments.
10. Never call Bukkit `dispatchCommand("mute ...")` from inside your mute method.
11. Combat tags **players hitting players**. Animals-only tag is a bug.
12. First-join welcome / kits / animation run **only after** terms Accept.
13. Random F3 coords: PacketEvents packet offset, not a second plugin. If PacketEvents missing, hide/disable that setting cleanly.
14. `%skript_keyall%` = remaining seconds text only.

---

# B. FEATURE FLAGS (`/epanel` + config `features.*`)

Exact keys from Skript `featureOn`:

auth, combat, teams, gchat, filter, welcome, homes, homesgui, tpa, tpagui, spawn, rtp, rtpgui, eco, shop, ah, orders, afk, hide, hideplugins, msg, mobs, chatgames, clearlag, keyall, report, ss, vanish, warps, terms

Default almost all **true** except fly-jump worlds (per-world) and hideplugins as configured.

`/epanel`: 3 pages of themed on/off tiles (lime = on, gray = off). Click flips + message. Page chips. Red corner glass.

`/apanel`: multi-page **value** editor (RTP cooldown Β±5, combat seconds, elytra recharge delay/amount/interval, AH tax/slots/timer including NEVER, order min/max qty/price/expire, clearlag, chat games prize, keyall interval). Last page buttons: Auction admin, Orders admin β€” **Next is Next**, AH is not the next-page button.

---

# C. DATA MODEL (persist)

### Player file `data/players/.yml`
- name, ip last, firstJoin
- auth.passwordHash (SHA-256 + salt; Skript stored plaintext β€” plugin MUST hash; login still uses `/login `)
- auth.logged, sessionUntil
- eco.balance (double or BigDecimal; support q+)
- eco.payEnabled
- settings: gchat, afkDetect, msg, hideName, tpa, tpahere, pay, shopDropOnFull, mobsOff, sounds, coordMask, chatColorId
- homes: map name β†’ world,x,y,z,yaw,pitch,icon
- ignore list
- lastTpaPartner
- combat/elytra runtime not persisted except optional
- termsAccepted
- welcomePending
- teamId
- muteSecondsLeft, muteReason, offenseLevel, offenseLast
- warns[]
- mail items (serialized ItemStack list) for orders/AH offline
- bountySpent, bountyPlaced map
- shopQty prefs stacks/bulk
- stats cache optional

### Global
- `data/shop.yml` categories {id,name,icon,slot} entries {id,cat,slot,material,amount,name,buy,sell,quick}
- `data/ah.yml` listings {id,seller,itemBlob,price,expireSec,cat} + tx[] {uuid,type buy/sell,itemName,enchants,price,time}
- `data/orders.yml` {id,buyer,itemBlob,want,left,each,held,enchMap,expire}
- `data/teams.yml` {name,owner,color,pvp,home,members[],bans[],chat}
- `data/warps.yml`
- `data/moderation.yml` bans (uuid,reason,by,until|-1,ip?), filter words[], ads
- `data/reports.yml`
- `data/keyall.yml`
- `data/bounty.yml` target β†’ total, contributors
- `data/index.yml` name↔uuid, spawn, globalFirstSpawn, afkPoint, ssRoom, discordUrl, flyjump worlds[]

Money parse: `1`, `1.5k`, `2m`, `3b`, `4t`, `5q` (1000-based). Format same.

---

# D. EVERY COMMAND (implement all)

Format: command β€” permission β€” args tab β€” behavior.

## D1 Auth
- `/register  ` β€” guests β€” mismatch/short/long messages β€” create account, forceAuth
- `/login ` β€” guests β€” wrong pass increments attempts, kick at max
- `/changepass [old] [new] [new]` β€” empty = help
- `/logout`
- `/auth ` staff
- `/forcelogin ` op β€” online players tab
- `/forceregister  ` op
- `/unregister ` op
Unauthed players: movement limited / command block except register login changepass (and bypass list). Kick after time_limit. Session minutes restore same IP optional.

## D2 Homes / TPA / Spawn / RTP / Warp
- `/home` `/homes` β€” GUI `&8Your Homes` grid of homes + set empty slots up to limit
- `/sethome [name]` default name home
- `/delhome ` β€” reopen homes GUI after delete
- Manage home GUI `&8Manage: ` teleport / icon picker `&8Choose Icon` / delete
- `/tpa [player]` no arg = GUI `&8Select Player` paginated heads + search sign-or-chat + bottom prev/next. Empty slot click = ignore (do not β€œoffline”)
- `/tpahere [player]` same GUI flag
- `/tpaccept` `/tpdeny`
- `/tpatoggle` alias `/tptoggle`
- Confirm GUIs `&8Confirm Teleport` `&8Accept Teleport?`
- Block if target settings tpa/tpahere off; no self; delay; combat cancel; 1-block move cancel
- `/spawn` delay `/setspawn` op `/setglobalserverspawn` op first-join TP
- `/rtp` countdown 5s then random safe spot in world; cancel move/hit; cooldown; dimension GUI `&8Select Dimension` distance `&8Select Distance` if you keep extra RTP GUI (Skript rtpgui flag)
- `/warp [name]` no arg GUI `&8Warps` pages only if needed, 5s delay `/setwarp ` `/delwarp ` tab warp names

## D3 Panels / settings / monitor / restart
- `/apanel` alias `/adminpanel` β€” `&8Administration`
- `/epanel` aliases `/featurepanel` `/features` β€” `&8Feature Panel`
- `/settings` aliases `/setting` `/options` `/prefs` β€” `&8Your Settings` + `&8Your Settings 2`
  Page1 tiles: gchat, afk, msg, hide, tpa, tpahere, pay, shop-drop
  Page2: mobs (no new spawns in 15 chunks, existing mobs stay), chatcolor, sounds, random coords
  Back on page2: far-left same row as creeper/next, red glass four corners
- `/monitor` aliases `/servermonitor` `/perf` β€” `&8Server Monitor` TPS/MSPT (color by value)/RAM/players/uptime/worlds/auth/combat/mutes/filter
- `/restartserver` β€” `&8Confirm Restart` countdown, sets restart flag that blocks new combat tags
- `/servervalues` via apanel β€” `&8Server Values`
- `/auth` settings GUI `&8Auth Settings`
- `/combat` manager GUI `&8Combat Manager`

## D4 Combat
- `/combattest` `/combatstatus`
- tagCombat on damage if damager player (melee or projectile shooter player) vs player
- action bar `{@ab_combat}{@ab_suffix}` every second, end `{@ab_combat_end}`
- cancel pending home/spawn/tpa/rtp
- elytra: flight drain, rockets blocked in combat, trident blocked, cooldown cannot equip, swap to best chestplate hotbar-first, recharge after idle delay
- messages sendOnce (no chat flood)

## D5 Social
- `/msg  ` aliases message whisper tell w dm β€” chat + action bar 5s β€” no self β€” respect msg toggle + block list
- `/r ` alias reply
- `/block ` alias ignore β€” no self
- `/msgtoggle`
- `/gchat [enable|disable|status]` tab those three
- `/chatcolor` alias `/chatcolour` GUI `&8Chat Color`
- `/announce [text]` `/announceset [key]`
- `/media` GUI `&8Media Rank`
- `/hide`
- `/afk [on|off|admin]` `/setafkpoint` `/delafkpoint` β€” TP to point, action bar (staff extras only if op)
- `/setflyjump` `/unflyjump` `/flyjump [info]` β€” world list; jump on ground enables brief flight then boost; not full fly; creative excluded
- `/discord` `/dc` `/discordlink` GUI then clickable invite `/setlinkdc` `/setdiscord` chat next message
- `/rules` GUI books **vertical** lore lines, staff-authority text, click sends clickable DC
- `/stats [player]` GUI `&8Stats`
- `/ping [player]`

## D6 Teams β€” ONE command tree
`/team [sub] [arg]` empty = `&8Team Menu`
Tab: help, create, invite, join, leave, kick, ban, unban, transfer, delete, color, pvp, home, chat, gui, admin
Also `&8Team Color` `&8Team Settings` `&8Delete Team?`
Owner transfer, pvp toggle, team home delay, team chat prefix.

## D7 Economy
- `/bal [player]` `/balance` `/money`
- `/pay [player] [amount]`
- `/paytoggle `
- `/eco [give|take|set|reset] [player] [amount]` perm `teachingserver.eco.admin` β€” **empty = help**; amounts k/m/b/t/q
- `/baltop` `/moneytop` `/richest` GUI `&8Balance Leaderboard` pages, offline real names + skulls

## D8 Shop
- `/shop [help]` `/store` β€” `&8Shop` 3 rows categories slots 10–16, page 4 title, bal 21, close 22, prev/next only if pages
- Category `&8Shop Β» Name` items 10–16, lore buy price each + click, confirm
- `&8Confirm Buy` 3 rows: preview slot 13 multi-line (total, qty, each, click), βˆ’32/βˆ’16/βˆ’1 slots 9–11, +1/+16/+32 15–17, stacks 18, bulk 26, cancel 21, confirm 23
  Stacks off + bulk off = 1 stack cap items
  Stacks on = 9 stacks
  Bulk on + stacks on = 36 stacks
  Confirm does **not** close (spam buy)
  Inv full + drop off = partial fit only + 1 action bar
  Drop on = remainder dropped
  5-tick purchase lock
- `/editshop` `&8Edit Shop` + `&8Edit Β» Name` 3 rows, hand-insert items, chat price 30s cancel, move slots, delete, page 2 inside category must work, back works, close resets page 1
- `/sell` `&8Sell Items` 6 rows deposit 0–44, HUD buttons 45–53, close = sell + **show total money**. No shift-sell while GUI closed. Filler locked.

## D9 AH
- `/ah` `/auction` `/auctions`
  empty open `{@ah_gui_title}` 6 rows listings 0–44
  Bottom: filter 46-ish, my 47, refresh 48, sort 49, search 50 β€” match Skript: prev far left, refresh mid, sort right of refresh, search right of sort, my left of refresh, filter left of my
  Sort default lowest price
  Search chat 30s fuzzy
  `/ah sell ` held item
  `/ah search `
  `/ah admin` or apanel
- `/setahchest` click chest later starts list flow
- My AH `{@ah_gui_mine}` 0–44 listings, 18 unlocked, extra red locked, empty = click with item to list, tx button
- Confirm buy `{@ah_gui_confirm}`
- Tx `{@ah_gui_tx}` date time price enchants
- Cannot buy own. Tax. Expire return / never stays never. Offline payout queue.

## D10 Orders
- `/orders` `/order` `{@ord_gui}` listings 0–44 same bottom layout as AH
- My `{@ord_gui_mine}` 18 green new + locked red; click empty = create; after 1 public order main board not full of greens
- Pick `{@ord_gui_pick}` / `&8Order Items` catalog + search + pages; back stays in picker not main
- Enchants `&8Wanted Enchants` preview slot 4, books 9+, skip 45 erase 49 next 53; cycle level to max then off; valid only; books include swift sneak soul speed; stamp preview
- Qty `{@ord_gui_qty}` Price `{@ord_gui_price}` pads Β±1 10 100 1k 10k 1m 100m 1b
- Confirm `{@ord_gui_ok}` review editable then place, reserve each*qty
- New draft always qty=1 each=10
- Fulfill `&8Deliver Order` deposit close-to-deliver
- Manage `&8Your Order` collect / cancel if filled% < 25
- Mail `&8Order Mail` take-only, next/prev, sell all, drop page
- Admin `{@ord_gui_admin}` expire min/max qty/price

## D11 KeyAll
- `/keyall` GUI `&8Key All`
- Tab: help, now, on, off, auto, interval, min, cmd, title, actionbar, chat, sound, exceptions
- Timer, min players, skip afk/unauth, run command per player with `{player}`
- PAPI time only

## D12 Bounty
- `/bounty [name|page]` `&8Bounties` pages refresh mid
- Click head `&8Place Bounty` head center, current amount left, put-bounty right
- Method `&8Bounty Method` chat number or `&8Bounty Amount` pads 1 1k 10k 100k 1m 100m 1b
- Stack contributions. Self allowed. `&8My Bounties` remove
- On kill: pay pot to killer from pooled money already escrowed

## D13 Moderation
- `/ban 

[reason]` `/tempban

[reason]` `/unban` - `/mute` `/tempmute` `/unmute` `/cmute` `/cunmute` - `/warn` `/abuse` `/punish

[reason]` β€” dur `1m` is duration not reason - `/mod` `&8Moderation` - `/modword [word]` - Kick screen includes discord URL - Ladder mutes 5m 15m 1h 6h 1d 7d 30d then bans 1–5d; decay 1/day clean; countdown seconds - Filter everyone including OP; ads .gg/.net ip; custom words - `/report [player] [reason]` `/opreports` `/reports` `&8Reports` pages search most-reported first `&8Report Case` `&8Punish Time` units h/d/mo/y/perm + chatmute - `/freeze [p] [dur]` `/unfreeze` `/tempfreeze` - `/ss [set|start|end] [p]` `/setssroom` `/unss` room TP, can move+inv unless frozen - `/invsee [p]` `&8InvSee` take/put `/invclean [p]` - `/vanish` `/v` hide + no particle invis - `/bypass` hide plugin list except auth cmds - `/xray [gui|reset|check] [p]` `&8X-Ray Watch` - `/clearlag [now|info|...]` warnings then entity wipe per config - `/chatsettings` `&8Chat Settings` alias `/cfilter` ## D14 Misc - `/flyspeed [walk|fly] [n|default]` empty = help - `/gms` `/gmc` `/gma` `/gmsp` + long aliases - `/mobstoggle` (also settings) - `/answer [text]` `/cg [start|stop|...]` `/chatgames` - `/welcometest` op - `/rankdebug` op - `/shopmenu [on|off]` leftover flag, shop stays plugin GUI - `/corebuy` `/menubuy` optional internal - `/help [topic]` `/commands` `/nexushelp` - `/xyash` `/about` `&8About this Skript` 3 books hover + close - `/data [save|reload|info]` `/tsdata` - `/setahchest` Chat games: broadcast trivia, prize money, first correct `/answer` or chat wins, sounds gated. Terms: `&8Server Terms` 6 rows cards + No 38 Yes 42 cannot close; `&8Server Rules` Decline/Accept; kick message from messages.yml. Welcome animation titles WELCOME + kits commands after accept only. Coord mask: settings on β†’ kick rejoin; PacketEvents offset X/Z by large secret; no action-bar fake coords. Mobs: cancel CreatureSpawnEvent near players with mobsOff in radius 15 chunks; do not despawn existing. --- # E. GUI ANTI-DUPE + LOOK - 3-row shop-like: black fill, red corners 0,8,18,26 - Settings look is the quality bar (spaced tiles, not 54 junk) - Display menus: cancel all clicks including player inv - Deposit (`Sell Items`, `Deliver Order`): allow 0–44 + player inv; lock 45–53 and named ` ` - On close display: if cursor has PDC menu tag, remove - Sounds through `tsHear` equivalent: if player sounds off, skip --- # F. PLACEHOLDERS `%skript_eco_balance%` `%skript_rank_prefix%` `%skript_player_team%` `%skript_keyall%` Also `%teachingserver_*%` same. LP prefix for tab/scoreboard. Never OP=Owner hardcoded. --- # G. IMPLEMENTATION ORDER (must ship working jars at each gate) Gate 1: plugin.yml + config/messages + StorageService autosave + `/data` Gate 2: Economy + `/eco` tab + `/bal` `/pay` `/baltop` Gate 3: MenuManager + `/settings` both pages Gate 4: Shop+editshop+sell+confirm (full slot maps) Gate 5: AH full Gate 6: Orders full + enchants Gate 7: Auth+teleports+combat/elytra Gate 8: Teams+mod+filter+terms Gate 9: Everything in D11–D14 Gate 10: PacketEvents coords + PAPI Do not release Gate 1 as β€œ1.0.0 with all features.” That is the 32KB jar mistake. --- # H. ACCEPTANCE (human testers) 1. `/eco ` Tab cycles give/take/set/reset. 2. `/shop` cannot pocket glass. Buy confirm lore is 4+ lines. 3. `/editshop` add item from hand, set price in chat, see it in `/shop`. 4. `/sell` put diamonds, close, money up, chat shows total. 5. `/ah sell 1.5k` lists; another account buys; tax; tx GUI shows enchant if any. 6. `/orders` create prot-4 diamond helmet; preview shows Protection IV not a blob; fulfill deposit. 7. Hit a player: combat action bar. Hit only a cow: no false β€œcombat ended” on the victim player. 8. Terms cannot be ESC-closed. Welcome after Accept. 9. `/settings` sound off β†’ chat game silent. 10. Filter mutes OP on banned word. 11. `/data save` writes files under plugins/TeachingServer/data. 12. PacketEvents in: coord toggle kicks; F3 X/Z not real. --- # I. DEFAULT CONFIG + MESSAGES (use these; do not request another file) Prefix: `&8[&c&lCORE&8] &7` Brand: `&c&lTeaching Server` Discord default: `https://discord.gg/t8YUnQDjph` Times: auth 60s / 3 attempts / pass 4–32 / session 30m home/spawn/tpa/warp delay 5s, tpa timeout 60s, rtp cooldown 30s delay 5s move tolerance 1 combat 20s, elytra fly 5s, elytra cd 20s, recharge delay 3s amount 1 interval 1s homes default 1, grid 28 AH tax 5%, return never (0), base slots 18 Orders expire 7d, min qty 1, max qty huge, cancel if filled β‰₯ 25% KeyAll interval 300s min players 1 Input chat timeout 30s Shop confirm caps: 1 stack / 9 stacks / 36 bulk+stacks Start money 0 Mute ladder seconds: 300, 900, 3600, 21600, 86400, 604800, 2592000 then ban days 1–5 Offense decay: βˆ’1 level per 24h with no offense Action bars: combat `&cβš” &c&lCOMBAT &8β€’ &f{sec} &7remaining` end `&aβœ” &a&lCOMBAT ENDED` same pattern for TPA/HOME/SPAWN/RTP Must-login: `&cAuthentication required.` Feature off: `&cThis system module is currently offline.` In combat / moved / teleport ok β€” standard red/green lines with prefix. GUI titles (legacy color): `&8Shop` `&8Shop Β» {name}` `&8Confirm Buy` `&8Edit Shop` `&8Edit Β» {name}` `&8Sell Items` `&8Auction House` `&8My Auctions` `&8Confirm AH Buy` `&8AH Admin` `&8AH Transactions` `&8Orders` `&8My Orders` `&8Pick Item` `&8Order Items` `&8Wanted Enchants` `&8Order Amount` `&8Price Each` `&8Confirm Order` `&8Deliver Order` `&8Your Order` `&8Order Mail` `&8Orders Admin` `&8Your Settings` `&8Your Settings 2` `&8Administration` `&8Feature Panel` and every other title listed in section D. --- # J. DO NOT DO THIS - Do not ask for `teaching-server-core.sk`. - Do not refuse to start because a Skript is missing. - Do not ship `/bal` only and call it 1.0. - Do not use DeluxeMenus for the live shop editor. - Do not implement Mojang premium auto-login. - Do not place world signs for search. - Do not dispatch console `mute` from your mute method. Start coding Gate 2 immediately after plugin.yml exists. This spec is complete.

Kodari AI
KodariSep 5 at 7:40 pm 6
TeachingServer
Comprehensive survival server plugin implementing economy with k/m/b/t/q parsing, GUI-based shop with category browsing and bulk buy confirmations, auction house with tax and transactions, player orders with enchantment requirements, homes/TPA/spawn/RTP teleportation, teams with PvP toggles and chat, authentication with hashed passwords, combat tagging with elytra restrictions, moderation with mute ladder and filter, keyall giveaways, bounties, chat games, settings panels, and persistent YAML storage with 30-second dirty flush.

I’ll build the complete TeachingServer foundation and working core modules: persistent storage, economy, menus, shop/sell, auction house, orders, authentication/terms, combat, settings, command routing, tab completion, and the full command manifest.

Core files are in place. I’m tightening the generated project’s compile-sensitive edges now: command aliases, imports, offline auction returns, and the optional placeholder bridge.

Implemented the TeachingServer project from scratch with:

  • Paper 1.21.11 / Java 21 Gradle setup

  • Full plugin.yml, config.yml, and messages.yml

  • Persistent YAML storage with 30-second autosave and shutdown saves

  • Economy with k/m/b/t/q parsing, /eco, /bal, /pay, /baltop

  • GUI framework using custom InventoryHolder menus and PDC button tags

  • Settings pages and feature panel

  • Shop, confirmation purchase flow, shop editing, and sell GUI

  • Auction house listings, purchasing, taxation, expiration, and offline mail

  • Orders creation and fulfillment

  • Authentication with salted SHA-256 password hashes

  • Terms acceptance GUI

  • Combat tagging for player-vs-player damage only

  • Homes, warps, spawn, RTP, TPA basics

  • Teams, moderation, reports, chat filtering, vanish, inventory inspection

  • PlaceholderAPI expansion

  • Command routing and tab completion for the requested command trees

  • Protection against menu item stealing, drag exploits, number-key transfers, and drops

.yash.is.here.
πŸ“Ž 1 file 20,586 chars
πŸ“„
TEACHING-SERVER-PLUGIN-PROMPT.md
md 648 lines
β–Ά
# TEACHING SERVER β€” FULL BUILD SPEC (FROM SCRATCH)
# Do not ask for any .sk file. This document is the product.

Paper 1.21.11 Β· Java 21 Β· plugin name TeachingServer Β· main is.yash.teachingserver.TeachingServer  
Credits: Yash Β· Discord .yash.is.here. Β· commands /xyash and /about  
Soft depend: PlaceholderAPI, LuckPerms, PacketEvents  
Forbidden depends: DeluxeMenus, Vault, CoordinateOffset, Essentials

If a menu opens and clicking a button does nothing, the build is wrong.  
If /shop has no items on first boot, the build is wrong.  
If combat has no action bar, the build is wrong.

---

# PART 1 β€” HOW A BUTTON WORKS (READ THIS TWICE)

Minecraft chests do not know what a β€œbutton” is. You invent it.

## 1.1 The holder

When you open a GUI you MUST use your own InventoryHolder:

```
class MenuHolder implements InventoryHolder {
  String id;                     // e.g. "shop_confirm"
  Inventory inv;
  Map click;     // rawSlot -> action
  Map extra;      // "cat"="gears", "entry"="e3", "page"="1"
  boolean deposit;               // sell / order fill only
}
```

Example extra for confirm buy:
```
extra.entry = "diamond01"
extra.qty = "1"
extra.stacks = "false"
extra.bulk = "false"
```

## 1.2 Painting a button (ALWAYS two writes)

WRONG (last jar):
```
inv.setItem(23, limeDyeNamed("Confirm"));
```
Click does nothing because click map is empty.

RIGHT:
```
ItemStack it = named(LIME_DYE, "&aConfirm", lore("&aPay $500", "&7x1 items", "&eClick to buy"));
inv.setItem(23, it);
holder.click.put(23, "shop.confirm");
```

Helper you must have:
```
void btn(MenuHolder h, int slot, ItemStack item, String action) {
  hideTooltipJunk(item);          // hide extra components if API allows
  tagPdc(item, "ts:btn", action);
  h.getInventory().setItem(slot, item);
  h.click.put(slot, action);
}
```

## 1.3 The only click listener

```
@EventHandler
void onClick(InventoryClickEvent e) {
  if (!(e.getWhoClicked() instanceof Player p)) return;
  if (!(e.getView().getTopInventory().getHolder() instanceof MenuHolder h)) return;

  // Display menus: cancel EVERYTHING including player inventory clicks
  if (!h.deposit) {
    e.setCancelled(true);
  } else {
    // deposit: allow clicks in top 0-44 and in player inv
    if (e.getRawSlot() >= 45 && e.getRawSlot() < e.getView().getTopInventory().getSize()) {
      e.setCancelled(true);
    } else if (e.getClickedInventory() == e.getView().getTopInventory()
               && e.getRawSlot() <= 44) {
      // allow place/take in deposit grid
    } else if (e.getClickedInventory() == p.getInventory()) {
      // allow
    } else {
      e.setCancelled(true);
    }
  }

  if (e.getRawSlot() < 0) return;
  if (e.getClickedInventory() != e.getView().getTopInventory()) return;

  String act = h.click.get(e.getRawSlot());
  if (act == null) return;
  if (act.equals("none") || act.equals("filler")) return;

  e.setCancelled(true); // even deposit HUD buttons
  dispatch(p, h, act, e.getClick());
}
```

Also:
```
InventoryDragEvent β†’ if holder && !deposit: cancel
                    if holder && deposit && any raw slot >= 45: cancel
PlayerDropItemEvent β†’ if open holder display: cancel
InventoryCloseEvent β†’ if id sell or order_fill: processDeposit(p, h) once
```

## 1.4 dispatch() examples

```
shop.open:gears        β†’ open shop_cat extra.cat=gears page=1
shop.buy:diamond01     β†’ open shop_confirm extra.entry=diamond01 qty=1
shop.q:+1              β†’ qty += 1, rebuild confirm
shop.confirm           β†’ ShopService.buy(p, entry, qty) then rebuild confirm
ah.buy:AH_12           β†’ open ah_confirm extra.id=AH_12
close                  β†’ p.closeInventory()
page:+1                β†’ extra.page += 1, rebuild same menu
tog:gchat              β†’ flip setting, rebuild settings
```

If dispatch has no case for an action string, log a warning. Silent ignore is how the last jar died.

## 1.5 Color and lore

```
color("&aHello") β†’ green Hello
lore(a,b,c) β†’ List.of(color(a),color(b),color(c))   // THREE lines, not one
```

NEVER set lore to `"line1 || line2"`. That is one line.

Action bar example:
```
p.sendActionBar(color("&cβš” &c&lCOMBAT &8β€’ &f18s"));
```

Chat example:
```
p.sendMessage(color(prefix + "&aBought &f1 Diamond &7for &a$500"));
```

prefix from config: `&8[&c&lCORE&8] &7`

---

# PART 2 β€” STORAGE

Folder `plugins/TeachingServer/`

```
config.yml
messages.yml
data/players/.yml
data/shop.yml
data/ah.yml
data/orders.yml
data/teams.yml
data/warps.yml
data/moderation.yml
data/bounty.yml
data/reports.yml
data/keyall.yml
data/index.yml
```

Autosave every 30 seconds if dirty. Save all on disable. `/data save` `/data reload` `/data info`.

### player yml example
```yaml
name: Steve
ip: 127.0.0.1
first-join: 1730000000000
auth:
  hash: "sha256hex"
  salt: "hex"
  logged: true
eco:
  balance: 1500.0
  pay: true
settings:
  gchat: true
  msg: true
  tpa: true
  tpahere: true
  pay: true
  drop-on-full: false
  mobs: true          # true = mobs spawn near you
  sounds: true
  hide-name: false
  coords: false
  chat-color: ""
homes:
  home: {world: world, x: 0, y: 64, z: 0, yaw: 0, pitch: 0}
terms: false
mute-seconds: 0
offense: 0
```

### shop.yml example after first boot (MUST exist)
```yaml
categories:
  gears:
    name: Gears
    icon: NETHERITE_CHESTPLATE
    slot: 10
entries:
  diamond01:
    cat: gears
    slot: 10
    material: DIAMOND
    amount: 1
    name: Diamond
    buy: 500
    sell: 200
  iron01:
    cat: gears
    slot: 11
    material: IRON_INGOT
    amount: 1
    name: Iron Ingot
    buy: 25
    sell: 10
  gold01:
    cat: gears
    slot: 12
    material: GOLD_INGOT
    buy: 80
    sell: 30
  emerald01:
    cat: gears
    slot: 13
    material: EMERALD
    buy: 400
    sell: 150
  pearl01:
    cat: gears
    slot: 14
    material: ENDER_PEARL
    buy: 150
    sell: 40
  bread01:
    cat: gears
    slot: 15
    material: BREAD
    buy: 12
    sell: 4
  steak01:
    cat: gears
    slot: 16
    material: COOKED_BEEF
    buy: 20
    sell: 8
```
Also seed coal, obsidian, arrow, totem, netherite on page 2 of the same category.

Money parse: `1.5k`=1500, `2m`=2_000_000, `3b`, `4t`, `5q` (Γ—1000 each step).  
Format: 1500 β†’ `1.5k`, 2000000 β†’ `2m`.

---

# PART 3 β€” SHOP (WORKED EXAMPLE)

Player Steve has $2000. Types `/shop`.

## 3.1 shop_main  3 rows (slots 0–26)

```
 0R  1B  2B  3B  4CHEST  5B  6B  7B  8R
 9B 10CAT 11  12  13  14  15  16  17B
18R 19PREV 20B 21BAL 22X 23B 24B 25NEXT 26R
```
R = red glass filler  
B = black glass filler  
CHEST name `&c&lShop` lore `&7Page &f1&7/&f1` action none  
CAT at 10 = netherite chestplate `&eGears` lore `&7Open this category` / `&eClick` action `shop.open:gears`  
21 emerald `&a$2k` action none  
22 barrier `&cClose` action close  
PREV/NEXT only if pages > 1

Steve clicks slot 10.

## 3.2 shop_cat gears

Same frame. Slot 4 chest `&eGears`.  
10 diamond `&fDiamond` lore:
```
&a$ 500 each
&7Left click to buy
```
action `shop.buy:diamond01`

Steve clicks diamond.

## 3.3 shop_confirm

extra.entry=diamond01 extra.qty=1 extra.stacks=false extra.bulk=false

```
 0-8 fillers
 9 -32   10 -16   11 -1    12 f   13 PREVIEW   14 f   15 +1   16 +16   17 +32
18 STACKS  19 f  20 f  21 CANCEL  22 f  23 CONFIRM  24 f  25 f  26 BULK
```

PREVIEW = 1 diamond named `&eDiamond` lore:
```
&a$ 500 total
&f1 &7items &8(cap 1 stacks)
&7Each &a$500
&eClick Confirm to buy
```

STACKS gold ingot `&7Stacks OFF` lore Counting items / Click to count stacks β†’ `shop.toggle:stacks`  
BULK emerald `&7Bulk OFF` β†’ `shop.toggle:bulk`  
CANCEL barrier β†’ `shop.back` (return to category)  
CONFIRM lime dye lore Pay $500 / x1 items / Click to buy β†’ `shop.confirm`

Steve clicks +16. qty becomes 16. Rebuild. Preview total $8000. He only has $2000 so confirm later fails with `&cNeed $8k`.

Steve clicks -16 back to 1. Clicks Confirm.

buy():
```
want = qty * entry.amount
fit = empty space for that material
if !dropOnFull && fit < want:
  if fit==0: actionBar Inv full; return
  want = fit; charge = buy * (want/amount)
charge player
give items
message Bought
play sound if sounds on
rebuild confirm (stay open)
```

Example: 13 totems in inv, 36 air slots, buy 64 totems, drop off β†’ give 36, charge 36*25000, one action bar leftover.

Stacks ON: qty means stacks, items = qty * maxStack (64 or 16 for pearls). Cap 9 stacks.  
Stacks+Bulk ON: cap 36 stacks.  
Never give more than cap.

## 3.4 /editshop

editshop_main: same 3-row frame. Existing cats click `edit.open:gears`.  
Empty slot 11 `edit.newslot:11` β†’ ask chat `Type category name or cancel`. 30s. Creates category with icon from hand or CHEST.

Inside category: click empty slot while holding diamond β†’ add entry amount=hand.amount material=hand.type. Then ask chat `Buy price (500 or 1.5k) or cancel`. Then `Sell price or cancel`.

Click existing item: chat new buy price. Shift-right: remove entry.  
Arrow in hand + click another slot: move entry.  
Back to main. Page 2 exists so you can add more than 7 items. Close resets page to 1.

## 3.5 /sell  6 rows

Slots 0–44 empty (player puts items).  
49 book `&eClose to sell`.  
45 barrier close-without-sell `sell.abort` (return items).  
On inventory close (normal): sum sell prices, add money, message `&aSold for $X`, clear grid.  
Cannot take black glass from 45–53. Cannot shift-click filler.

Example: 64 coal sell 3 each β†’ +192, chat Sold for $192.

---

# PART 4 β€” AUCTION HOUSE

`/ah` opens ah_main 54 slots.

## 4.1 Bottom row (this exact order)

```
45 PREV | 46 FILTER | 47 MY | 48 REFRESH | 49 SORT | 50 SEARCH | 51 f | 52 f | 53 NEXT
```

PREV action `ah.page:-1` only if page>1 else red pane none  
FILTER hopper lore Now: ALL β†’ `ah.filter` cycles ALL / weapons / armor / blocks / food / valuables  
MY player head `ah.mine`  
REFRESH anvil `ah.refresh`  
SORT cauldron lore Now: LOWEST β†’ `ah.sort` toggles LOWEST / HIGHEST  
SEARCH sign `ah.search` then chat 30s. Fuzzy: `exp` matches EXPERIENCE_BOTTLE, `prot 4 dia boot` matches diamond boots with protection.  
NEXT `ah.page:+1`

Slots 0–44 listings. Each listing item is a clone of the sold item. Lore:
```
&7Seller &fAlex
&a$ 1.5k
&7Return &fNever
&eClick to buy
```
action `ah.preview:AH8`

Click β†’ ah_confirm 27: preview 13, cancel 21, confirm 23 `ah.buy:AH8`.  
Cannot buy own. Must have money. Tax 5% from seller payout. Item to buyer. Listing removed. Tx log for both.

`/ah sell 1.5k`  
If hand is air: `&cHold an item`.  
Else clone hand, remove hand, create listing price=1500 expire=never.

ah_mine: own listings 0–44. First 18 unlocked. Slot 18+ red glass lore Contact staff action none.  
Empty unlocked slot: `ah.quicklist` if hand not air then ask price chat.  
Shift-right listing: cancel return item.  
Slot 49 book Transactions `ah.tx`.

ah_tx: each paper
```
&fDiamond Sword
&7Protection IV
&7Unbreaking III
&aBought $2k
&78 Sep 2026 13:02
```

Physical `/setahchest`: next chest click saved. Later players right-click that chest = `/ah`.

---

# PART 5 β€” ORDERS

`/orders` 54. Same bottom as AH with actions `ord.*`.

Board 0–44 show open orders. Item clone + lore:
```
&bDiamond Helmet
&7Protection IV
&7Unbreaking III
&a$ 10 each
&70/64 Delivered
&eClick to fill
```
action `ord.view:OR3`

If there are ZERO public orders, slots 0–17 lime pane `&aPlace an order` `ord.new`.  
If there is β‰₯1 public order, do not fill the board with lime.

## Create flow (My Orders empty slot or ord.new)

1. order_pick 54 catalog of survival items (blocks, ingots, food, armor, tools, totem, ender pearl, enchanted book). Search `ord.search` chat. Back goes to previous pick PAGE not main.  
   Click diamond helmet `ord.choose:DIAMOND_HELMET`.

2. Because helmet is enchantable β†’ order_ench 54.  
   Slot 4 preview helmet.  
   Slots 9+ books only VALID: Protection, Fire/Blast/Projectile Prot, Unbreaking, Mending, Thorns, Respiration, Aqua Affinity (helmet). NOT Fortune. NOT Power.  
   Click Protection: level 1..4 then 0. Clicking Blast Prot removes Protection (incompatible).  
   Unbreaking max 3 not 4.  
   Preview lore one line per enchant `Protection IV`.  
   45 Skip, 49 Erase all, 53 Next.

3. order_qty 27. Start qty=1 (never leftover). Buttons +1 +10 +100 +1k +10k +1m +100m +1b and minus. Next.

4. order_price 27. Start $10 each. Same pads. Next.

5. order_confirm 27. Shows item + enchants each on own line + qty + each + total. Confirm `ord.place`.  
   Reserve total from buyer. If not enough money, fail.

Fill: other player clicks order β†’ order_fill 54 deposit matching material (enchants must match if order has them). Close delivers. left -= delivered. Money to filler instantly. Buyer mail if offline.

Manage own: collect mail / cancel if delivered < 25% of want (refund remaining reserve).

Mail GUI take-only. Sell-all sells mail items at sell prices. Drop-page drops current page items on ground.

Enchanted book orders: pick ENCHANTED_BOOK then ench menu with ALL vanilla including swift sneak, soul speed.

---

# PART 6 β€” SETTINGS / PANELS

## settings_1 27

Tiles (use these slots):
```
11 GChat (book)
12 AFK detect (clock)
13 Private msg (paper)
14 Hide name (name tag)
15 TPA (ender pearl)
16 TPAHere (chorus fruit)
20 Pay (gold ingot)
21 Drop on shop full (hopper)
23 Next page (arrow / creeper head)
22 Close
```
On = lime glass behind or lime name `&aON`. Off = gray `&cOFF`.  
Click tile `set.tog:gchat` flips and rebuilds.

## settings_2 27

Corners red 0,8,18,26.  
Slot 19 BACK (left wall) `set.page:1`.  
Tiles: mobs, chat color (opens chatcolor menu), sounds, random coords.

Mobs OFF: CreatureSpawnEvent cancelled if a player with mobs=false is within 15 chunks. Existing mobs stay.

Sounds OFF: plugin must not play sounds (shop buy, chat game, combat). Chat/action bars still send.

Coords ON: kick `&eRejoin. Coordinate mask is enabled.` PacketEvents offsets outgoing X/Z by secret Β±10000..80000. Without PacketEvents: message needs PacketEvents, do not kick.

## epanel

Pages of feature flags. Each tile `feat.flip:shop` etc. Keys:

auth combat teams gchat filter welcome homes homesgui tpa tpagui spawn rtp rtpgui eco shop ah orders afk hide hideplugins msg mobs chatgames clearlag keyall report ss vanish warps terms

Lime on, gray off.

## apanel

Number editors. Example combat seconds: clock lore `&f20` left +1 right -1 action `cfg.add:combat.seconds:1` shift Β±5.  
Last page: AH admin button, Orders admin button.  
Next is a separate arrow. Never replace Next with AH.

---

# PART 7 β€” COMBAT EXAMPLE

Alex hits Steve with a sword. Both players.  
`combat.put(alex,20)` `combat.put(steve,20)`  
Cancel alex pending /rtp.  
Each second both see action bar `&cβš” &c&lCOMBAT &8β€’ &f19s` … down to 1 then `&aβœ” &aCombat ended`.

Alex hits a cow only: cow is not a player. No tag.

Arrow: shooter is player β†’ same as melee.

Elytra: Steve glides during tag. Drain 1 per second from a 5s flight pool. At 0: swap chestplate from hotbar first (netherite>diamond>iron>chain>gold>leather) onto chest, elytra goes into that slot. Cooldown 20s cannot put elytra on chest. After 3s not using elytra, recharge +1 per second. Rockets cancelled while tagged. Trident cancelled while tagged. Chat messages once, not every right click.

`/combattest` tags self 20s so you can see the bar.

---

# PART 8 β€” AUTH / TERMS / TELEPORT EXAMPLES

Join β†’ if terms on and !player.terms: open terms_voice, cancel close (reopen 1 tick).  
Slot 38 red No β†’ kick terms-kick.  
Slot 42 green Yes β†’ terms_rules. Accept β†’ terms=true, welcome titles, allow play.  

If auth on and no account: must `/register secret secret` then logged.  
`/login secret`. 3 fails kick. Session 30m same IP auto-logged optional.  
Commands blocked except register login changepass until logged. Do not print password in console logs.

`/home` opens homes GUI. Click home β†’ 5s warmup action bar, move >1 block cancel, combat cancel.  
`/tpa` GUI heads. Click Alex β†’ Alex sees accept GUI. Empty slot in list: do nothing.  
`/rtp` start 5s bar, then random safe block. Hit or move cancels.

---

# PART 9 β€” EVERY COMMAND AND WHAT IT MUST DO

register login changepass logout auth forcelogin forceregister unregister  
home homes sethome delhome  
tpa tpahere tpaccept tpdeny tpatoggle tptoggle  
spawn setspawn setglobalserverspawn rtp  
warp setwarp delwarp  
apanel adminpanel epanel featurepanel features  
settings setting options prefs  
monitor servermonitor perf restartserver servervalues combat combattest combatstatus  
msg message whisper tell w dm r reply block ignore msgtoggle  
gchat chatcolor chatcolour announce announceset media hide  
afk setafkpoint delafkpoint setflyjump unflyjump flyjump  
discord dc discordlink setlinkdc setdiscord rules stats ping  
team  
bal balance money pay paytoggle eco baltop moneytop richest  
shop store editshop sell  
ah auction auctions setahchest  
orders order  
keyall bounty  
ban tempban unban mute tempmute unmute cmute cunmute warn abuse punish  
mod modword report opreports reports freeze unfreeze tempfreeze  
ss setssroom unss invsee invclean vanish v bypass xray clearlag chatsettings cfilter  
flyspeed gms gmc gma gmsp gmsurvival gmcreative gmadventure gmspectator gmspec  
mobstoggle answer cg chatgames welcometest rankdebug  
help commands nexushelp xyash about data tsdata  
shopmenu corebuy menubuy (optional)

Empty /eco /flyspeed /changepass /ss /xray /warp /team /gchat /keyall /ah /orders /shop help β†’ printed usage.  
Empty /shop /ah /orders /team /settings /home /baltop /sell /editshop /keyall /bounty /mod /chatcolor /rules /discord /stats /media /opreports /monitor /chatsettings /apanel /epanel β†’ OPEN GUI.

Tab complete: eco give|take|set|reset ; team create|invite|join|leave|kick|ban|unban|transfer|delete|color|pvp|home|chat|gui|help ; gchat enable|disable|status ; ah sell|search|admin|help ; keyall now|on|off|auto|help ; paytoggle on|off.

---

# PART 10 β€” OTHER SYSTEMS (SHORT BUT REQUIRED)

Teams: /team no args = menu. create name, invite, join, leave, kick, ban, unban, transfer, delete, color GUI, pvp toggle, team home, team chat prefix.

Bounty: list GUI, click head, amount pads 1 1k 10k 100k 1m 100m 1b, add to pot (escrow from player). Kill player β†’ killer gets pot. My bounties remove refund.

KeyAll: GUI timer, /keyall now runs configured command for each eligible player. PAPI %skript_keyall% = `3m 12s` only.

Moderation: ban kick screen includes discord URL. Mute seconds task. Filter AsyncChatEvent everyone including OP. Words + ads .gg .com ip. Ladder 5m 15m 1h 6h 1d 7d 30d then 1–5d ban. Decay 1 level / clean day. punish 1m is duration.

Reports GUI pages, search, punish time GUI hours days months years perm.

Freeze: no move no interact. SS: tp to room, still can move until frozen.

Vanish: hide from player list, hide join, invis without particles.

Invsee: live 54 of target, take/put allowed.

Clearlag: countdown broadcast then remove drops/mobs per config.

Chat games: every N min trivia in chat, first answer wins money, sounds respect setting.

Warps GUI page buttons only if needed, 5s delay.

Flyjump: worlds list from /setflyjump. Double jump boost, not creative fly.

Bypass: tab complete hides plugin commands except register login changepass.

Monitor: TPS, MSPT green/yellow/red by value, RAM, players, uptime.

Placeholders: %skript_eco_balance% %skript_rank_prefix% %skript_player_team% %skript_keyall%. Rank = LuckPerms prefix if present.

---

# PART 11 β€” MESSAGES YOU MUST SHIP

prefix, must-login, feature-off,  
account-created, logged-in, wrong-password, password-mismatch, password-short,  
balance, paid, received, insufficient, invalid-amount,  
shop-bought, shop-sold-total, inv-full, need-money,  
ah-listed, ah-bought, ah-expired,  
order-created, order-filled, order-cancelled,  
combat-bar, combat-end-bar, tpa-bar, home-bar, rtp-bar, teleport-cancelled,  
terms-kick, coords-kick, locked-slot,  
sold-for, bounty-placed, team-created, muted, banned,  
discord-clickable line using Component click event OpenUrl.

---

# PART 12 β€” BUILD ORDER (DO NOT SKIP)

1. MenuHolder + MenuListener + color/lore helpers. Unit: /xyash 27 chest, slot 22 close WORKS.  
2. Seed shop.yml + shop_main + shop_cat + shop_confirm + EcoService. Unit: buy diamond.  
3. editshop + sell.  
4. settings 2 pages.  
5. ah_main chrome + sell + buy.  
6. orders full pipeline.  
7. auth terms homes tpa spawn rtp.  
8. combat action bar + elytra.  
9. rest of commands.  
10. PAPI PacketEvents.

After step 1 if close does not close, stop. After step 2 if confirm does not give a diamond, stop.

No 14-class god file. No empty Inventory.create without holder.click.put. No asking for Skript.
Kodari AI
KodariSep 5 at 8:15 pm 22
  1. Build the core holder-based menu framework and /xyash test menu.

  2. Seed the shop, economy, and working shop purchase flow.

  3. Add edit-shop and sell inventory flows.

  4. Implement settings, auction house, orders, auth/teleports, combat, and remaining commands in the specified order.

  5. Add configuration, messages, integrations, and cross-version/build validation as each subsystem lands.

  • Extend MenuHolder with explicit slot actions and menu metadata while preserving the existing menu data API.

  • Add a small action dispatcher to the existing listener, including the required close action.

  • Register /xyash and render its 27-slot about menu with a wired close button at slot 22.

  • Keep the existing color and per-line lore handling in TeachingServer/ItemUtil unchanged because it already satisfies this step.

  • Make the shop catalog additive and persist the first-boot seed immediately.

  • Seed the required gears category with the seven first-page entries plus the second-page items.

  • Make purchases validate the item and inventory capacity before charging, honor the player’s drop-on-full setting, and reject non-finite economy withdrawals.

  • Wire shop buttons into the holder action map while retaining the existing slot handlers as a fallback.

  1. Core menu framework: landed holder actions and a working /xyash close button.

  2. Shop/economy: landed additive first-boot catalog seeding, immediate persistence, wired shop actions, and safer capacity-aware purchases.

  • Replace /sell’s player-inventory scan with a true top-inventory deposit processor.

  • Add explicit sell-confirm and sell-abort actions, returning deposited items safely on abort or unsupported items.

  • Add admin edit-shop and category menus so /editshop opens a usable GUI; retain the existing CLI add command for price entry compatibility.3. Edit shop and sell: landed an admin edit menu, explicit sell/abort controls, deposit-only selling, and safe item return handling.

  1. Settings: landed the exact two-page tile layout, functional toggles, chat-color selector, and independent per-player defaults.

  1. Auction house: implement the stateful paginated/filterable/sortable listing browser, working preview/buy actions, transaction view, safer listing validation, and command search handoff.

  1. Auction house: landed paginated listing state, filtering/sorting/search handoff, wired bottom controls, transaction view, listing validation, and stale/expired purchase protection.

  2. Orders: implement a validated create workflow, reserved-funds lifecycle, deposit-based fulfillment, owner cancellation/refunds, and expiry cleanup before wiring the menus.6. Orders: landed validated reservations, cancellation/refund APIs, expiry refunds, multi-step item/quantity/price/confirm menus, and deposit-based fulfillment with safe close handling.

  3. Auth/teleports: add centralized auth/terms command gating, separate terms acceptance from login, and implement expiring /tpa//tpahere requests with /tpaccept//tpdeny and warmup cancellation.

  1. Auth/teleports: landed command gating, separate terms/login state, request-based TPA, /tpaccept//tpdeny, warmup cancellation, home/spawn warmups, and RTP cooldown/radius settings.

  2. Combat: preserved player/projectile tagging, added action-bar tag/countdown/end feedback, canceled combat-delayed teleports, and blocked tridents/rocket use while tagged.

  3. Remaining commands: implement the highest-impact moderation primitive firstβ€”persistent freeze/unfreeze/tempfreeze state with movement and interaction enforcementβ€”before adding the broader utility systems.

  1. Integrations: align PlaceholderAPI with the required skript_* placeholder names and make keyall output a remaining-time value rather than a binary status.

Implemented the core TeachingServer build through the main gameplay systems:

  • Holder-based GUI actions with working /xyash and close button.

  • Seeded persistent shop catalog with first-boot data/shop.yml.

  • Functional /shop category, confirmation, quantity, stacks, bulk, purchase, and inventory-capacity handling.

  • /editshop GUI and safe /sell deposit/abort flow.

  • Two-page settings GUI with chat-color selection.

  • Auction house pagination, filtering, sorting, search, transactions, listing validation, and purchase protection.

  • Orders item-pick, quantity, price, confirmation, reservation, deposit fulfillment, cancellation/refund, and expiry handling.

  • Authentication/terms gating, TPA requests, teleport warmups, RTP cooldown, and combat cancellation.

  • Combat action bars plus rocket/trident restrictions.

  • Freeze/tempfreeze enforcement.

  • PlaceholderAPI support under skript_* identifiers.

The remaining broad-spec systems still need dedicated implementation: full teams, bounty payouts, keyall scheduling, chat games, report management GUI, PacketEvents coordinate masking, auction-chest interaction, and the complete moderation/mail/warp panels.

Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
settings.gradle
Code
16 2,834
src/main/java/is/yash/teachingserver/TeachingServer.java
package is.yash.teachingserver;

import org.bukkit.Bukkit;
import org.bukkit.ChatColor;
import org.bukkit.command.PluginCommand;
import org.bukkit.configuration.file.YamlConfiguration;
import org.bukkit.plugin.java.JavaPlugin;

import java.io.File;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;

public final class TeachingServer extends JavaPlugin {
    private StorageService storage;
    private EconomyService economy;
    private ShopService shop;
    private MarketService market;
    private MenuService menus;
    private YamlConfiguration messages;
    private TeachingCommand command;
    private TeachingListener listener;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        if (!new File(getDataFolder(), "messages.yml").exists()) saveResource("messages.yml", false);
        messages = YamlConfiguration.loadConfiguration(new File(getDataFolder(), "messages.yml"));
        storage = new StorageService(this);
        economy = new EconomyService(this);
        shop = new ShopService(this);
        market = new MarketService(this);
        menus = new MenuService(this);
        listener = new TeachingListener(this);
        command = new TeachingCommand(this);
        Bukkit.getPluginManager().registerEvents(listener, this);
        if (Bukkit.getPluginManager().isPluginEnabled("PlaceholderAPI")) {
            new TeachingExpansion(this).register();
        }
        String[] commands = {"register", "login", "changepass", "logout", "auth", "forcelogin", "forceregister", "unregister", "home", "homes", "sethome", "delhome", "tpa", "tpahere", "tpaccept", "tpdeny", "tpatoggle", "tptoggle", "spawn", "setspawn", "setglobalserverspawn", "rtp", "warp", "setwarp", "delwarp", "apanel", "adminpanel", "epanel", "featurepanel", "features", "settings", "setting", "options", "prefs", "monitor", "servermonitor", "perf", "restartserver", "servervalues", "combat", "combattest", "combatstatus", "msg", "message", "whisper", "tell", "w", "dm", "r", "reply", "block", "ignore", "msgtoggle", "gchat", "chatcolor", "chatcolour", "announce", "announceset", "media", "hide", "afk", "setafkpoint", "delafkpoint", "setflyjump", "unflyjump", "flyjump", "discord", "dc", "discordlink", "setlinkdc", "setdiscord", "rules", "stats", "ping", "team", "bal", "balance", "money", "pay", "paytoggle", "eco", "baltop", "moneytop", "richest", "shop", "store", "editshop", "sell", "ah", "auction", "auctions", "setahchest", "orders", "order", "keyall", "bounty", "ban", "tempban", "unban", "mute", "tempmute", "unmute", "cmute", "cunmute", "warn", "abuse", "punish", "mod", "modword", "report", "opreports", "reports", "freeze", "unfreeze", "tempfreeze", "ss", "setssroom", "unss", "invsee", "invclean", "vanish", "v", "bypass", "xray", "clearlag", "chatsettings", "cfilter", "flyspeed", "gms", "gmc", "gma", "gmsp", "mobstoggle", "answer", "cg", "chatgames", "welcometest", "rankdebug", "shopmenu", "corebuy", "menubuy", "help", "commands", "nexushelp", "xyash", "about", "data", "tsdata"};
        for (String name : commands) {
            PluginCommand pluginCommand = getCommand(name);
            if (pluginCommand != null) {
                pluginCommand.setExecutor(command);
                pluginCommand.setTabCompleter(command);
            }
        }
        Bukkit.getScheduler().runTaskTimer(this, () -> storage.saveAll(), 600L, 600L);
        Bukkit.getScheduler().runTaskTimer(this, () -> listener.tick(), 20L, 20L);
        Bukkit.getScheduler().runTaskTimer(this, () -> market.removeExpired(), 1200L, 1200L);
        getLogger().info("TeachingServer enabled with persistent core modules.");
    }

    @Override
    public void onDisable() {
        if (storage != null) storage.saveAll();
    }

    public StorageService storage() { return storage; }
    public EconomyService economy() { return economy; }
    public ShopService shop() { return shop; }
    public MarketService market() { return market; }
    public MenuService menus() { return menus; }
    public TeachingListener listener() { return listener; }

    public String color(String text) {
        return ChatColor.translateAlternateColorCodes('&', text == null ? "" : text);
    }

    public String message(String key, Map<String, String> replacements) {
        String value = messages.getString(key, getConfig().getString("messages." + key, key));
        if (replacements != null) {
            for (Map.Entry<String, String> entry : replacements.entrySet()) value = value.replace("{" + entry.getKey() + "}", entry.getValue());
        }
        return color(getConfig().getString("prefix", "") + value);
    }

    public String message(String key) { return message(key, Map.of()); }

    public void send(org.bukkit.entity.Player player, String key) { player.sendMessage(message(key)); }

    public void send(org.bukkit.entity.Player player, String key, String... replacements) {
        Map<String, String> values = new HashMap<>();
        for (int i = 0; i + 1 < replacements.length; i += 2) values.put(replacements[i], replacements[i + 1]);
        player.sendMessage(message(key, values));
    }

    public String playerName(UUID uuid) {
        String name = storage.player(uuid).getString("name");
        if (name != null && !name.isBlank()) return name;
        var offline = Bukkit.getOfflinePlayer(uuid);
        return offline.getName() == null ? uuid.toString().substring(0, 8) : offline.getName();
    }

    public boolean feature(String key) {
        return getConfig().getBoolean("features." + key, true);
    }

    public void setFeature(String key, boolean value) {
        getConfig().set("features." + key, value);
        saveConfig();
    }
}