秦淮系列文档

English

简体中文

English

简体中文

Appearance

Commands and Permissions ​

Previous: Reference Overview　·　Next: Message Copy Quick Reference

QS registers just one main command, /qs (aliases /qskills, /qskill), with 11 subcommands underneath. This page is a quick reference for the command tree and permission nodes.

📌 Running /qs with no arguments prints the runtime protocol status plus a usage hint — equivalent to a quick health check.

🌳 Subcommand summary ​

CommandArgumentsPermissionDescription
/qs reload—qinhskills.adminReload definitions / graphs / routes and sync the Mythic bridge
/qs protocol—qinhskills.useView runtime protocol, bridge status, Mythic availability
/qs bridge—qinhskills.useMythic bridge diagnostics (bridgeId / available / most recent request)
/qs list[player]use (self) / admin (others)List all skills: unlocked ✔/✘, level, remaining cooldown
/qs info<skill>qinhskills.useSkill definition details (type / MM skill / trigger / variables)
/qs unlock<skill> [player]qinhskills.adminUnlock a skill
/qs lock<skill> [player]qinhskills.adminLock (remove unlock)
/qs level<skill> <level≥1> [player]qinhskills.adminSet skill level
/qs slot<slot1-5> <skill|clear> [player]qinhskills.adminSet / clear a skill slot (clear/none to clear)
/qs cast<skill>qinhskills.castCast by command (players only, for testing / command bridge)
/qs silence<seconds> [player]qinhskills.adminBlock casting for N seconds (0 = release)

⚠️ <> is required, [] is optional. Commands with [player] default to the sender when omitted; operating on others always requires qinhskills.admin. The console has no "self," so every command with a player argument must spell out a player name explicitly when run from the console.

🔑 Permission nodes (plugin.yml) ​

PermissionDefaultScope
qinhskills.adminopreload, unlock, lock, level, slot, silence, operating on others
qinhskills.usetrueBasic use: list (self), info, protocol, bridge
qinhskills.casttrueCast skills via the /qs cast command
qinhskills.guitrueSkill-slot GUI (no usable command bound currently — internal / reserved)
qinhskills.ciopBuilt-in event-chain CI (internal, no public command exposed)
qinhskills.ci.verboseopOutput a trace when CI fails (internal)

💡 qinhskills.gui, qinhskills.ci, and qinhskills.ci.verbose currently have no usable player command bound — the GUI and CI (event-chain regression testing) are internal / reserved capabilities and are not exposed through /qs. The same goes for any /qs test or /qs gen you may see in documentation: not publicly exposed. Treat the 11 subcommands in the table above as authoritative.

⌨️ Tab-completion rules ​

Input positionCompletion
1st argumentSubcommand name (reload protocol bridge list info unlock lock level slot cast)
Skill position of info/unlock/lock/level/castRegistered skill ids
Slot position of slot1 2 3 4 5
Skill position of slotSkill id + clear
Player position of list/unlock/lockOnline player names
Player position of level/slotOnline player names

silence is not in the completion list (to avoid accidental triggers) — just type it directly.

🧪 Typical usage ​

bash
# Reload skill definitions and graphs (mandatory after editing YAML)
/qs reload

# View all skill states for a player
/qs list Steve

# Unlock and level up for a player
/qs unlock fire_wave Steve
/qs level fire_wave 3 Steve

# Bind a skill to slot 2
/qs slot 2 fire_wave Steve

# Cast by command (test whether a skill can fire)
/qs cast fire_wave

# Silence a player for 5 seconds / release
/qs silence 5 Steve
/qs silence 0 Steve

# Bridge and protocol diagnostics
/qs protocol
/qs bridge