NPCorePlugin

Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

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

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

Download NorrionProjectCorePlugin-<version>.jar
Place it in plugins/
Restart the server (not /reload)
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.