📚 Reference

This is the quick-lookup zone you keep coming back to while configuring QinhItems. The earlier chapters walk you from install through advanced play; this section is not a walkthrough but a lookup table: how to type a command, how to grant a permission, what every config.yml field means, what each placeholder is called, and which validation error maps to which fix, plus common questions and a glossary.

The pages are organized by the kind of question you have. Need a command? See Commands and Permissions. Editing config? Use Config (grouped by topic) or Annotated Config (line by line against the default file). Unsure what a given YAML file does? Check Resource Files. When a red error shows up, look it up in Validation Errors first, then reach for the commands in Diagnostics if you still cannot pin it down.

Read these pages on demand — you do not need to read them cover to cover. Bookmark this index, then jump into the matching child page whenever a concrete question comes up.

In this section

• ⌨️ Commands — The full /qi command tree: usage, arguments, and the permission each command needs.
• 🔑 Permissions — Every permission node, its default, and the parent/child structure, including the soulbound bypass node.
• ⚙️ Config — What each field in the main config means, explained section by section.
• 📄 Annotated Config — The complete default config text, annotated line by line.
• 🗃️ Resource Files — A map of every YAML / resource file in the plugin folder: what it owns and where to read the details.
• 💬 Messages — Server-customizable prompts and display formats, for translating or retoning.
• 🔣 Placeholders — The PlaceholderAPI placeholder list under the qinhitems identifier and their return values.
• 📋 Bundled Content — The full list of QI's built-in tiers, section / affix pools, and sets, ready to reference or copy.
• 🚨 Validation Errors — Each validation error message, its cause, whether it is an error or a warning, and the fix.
• 🩺 Diagnostics — How to read the diagnostic command output and what each metric means.
• 📈 Performance & Ops — Loading, refresh, and cache tuning for large item counts and high player counts.
• ❓ FAQ — Common pitfalls gathered from across the docs into grouped questions and answers.
• 📖 Glossary — QI's domain terms (definition / layer / bridge / capability, etc.) explained in one line each, with links.