NorrionProjectCorePlugin

The core of the NorrionProject ecosystem — Required for all NorrionProject plugins

---

!presentation NorrionProjectCorePlugin is the shared technical foundation for all plugins in the NorrionProject ecosystem. It is not a standalone gameplay plugin — it is mandatory for NPEnderChestPlugin, NPDiscordPlugin, NPPartiesPlugin, NPChiselPlugin, NPColiseumPlugin, and NPProjectPlugin (the main gameplay plugin) to function.

As a server admin, you don't configure this directly — it auto-configures through the plugins that depend on it.

Runs on both PaperMC and plain Spigot — Paper-only features (like live custom-block sync to nearby players) degrade gracefully instead of being required.

---

!features

Feature	Benefit for you
Unified configuration	Single plugins/NorrionProject/ folder for all configs
YAML/SQL storage	Persistent data, choose file or database backend
Multilingual (EN/FR)	Translated messages, extensible to more languages
Paginated commands	Clean /help with page navigation
Server ↔ Client relay	Communication with Fabric client mod (HUD, map, etc.) teasing feature :3
Vault Economy API	Auto-detects your economy plugin
Custom-block admin tools	Inspect, remove, or write custom blocks placed by any Norrion plugin, chunk by chunk
FastAsyncWorldEdit integration	Custom blocks (chisel variants, buildings, ...) survive //copy, //paste, and schematics — shared by every Norrion plugin that needs it

---

!setup

1. Download NorrionProjectCorePlugin-<version>.jar
2. Place it in plugins/
3. Restart the server (not /reload)
4. A plugins/NorrionProject/ folder is created automatically

Generated files

plugins/NorrionProject/
├── core-config.yml                           # Global config (language, SQL, etc.)
├── language/                                 # Translation files
└── <other norrion project plugins files>/    # Each dependent plugin creates its subfolder

---

⚙️ Configuration (config.yml)

All documentation is provided in plugins/NorrionProject/core-config.yml

Tip: On small/medium servers, keep use-sql: false (YAML files = zero config, auto-save).

---

!commands

Command	Description	Permission
/npcore customblock chunk [page]	Lists the custom blocks placed in the chunk you're standing in, with clickable page navigation (like /help)	norrion.core.admin
/npcore customblock target	Shows the custom block data (namespace, id, position, world) of the block you're looking at	norrion.core.admin
/npcore customblock remove <x> <y> <z>	Removes the custom block data at the given coordinates	norrion.core.admin
/npcore customblock write <namespace:id>	Force-writes a custom block type onto the block you're looking at (debug tool)	norrion.core.admin

---

📋 Dependencies

Plugin	Type	Why?
Vault	Optional	Economy (auto-detected if present)
NPCore (included)	Internal	Shared data models

---

!faq Q: I installed it but nothing happens?
A: Normal! It's a library. Install a plugin that depends on it (e.g. NPEnderChestPlugin) to see gameplay features.

Q: Can I use it for my own plugins?
A: This is not recommended, it's built specifically for the NorrionProject ecosystem and can change drastically, making code maintenance difficult. At least for now.

Q: How do I change the language?
A: Edit locale: "en" in config.yml then restart.

---

!support No plugin fits every server out of the box. If there's a feature, an integration with another plugin, or a tweak you need and don't see here, come tell us on Discord — that's exactly how this plugin keeps improving.

---

!links

• Website & Wiki: norrion.eu
• Support / Bugs: Norrion Discord

---

Part of the Norrion server ecosystem.