NorrionProjectCorePlugin
NorrionProject 生态系统的核心 —— 所有 NorrionProject 插件均必需
NorrionProjectCorePlugin 是 NorrionProject 生态系统中所有插件的共享技术基础。它不是一个独立的游戏玩法插件——它是 NPEnderChestPlugin、NPDiscordPlugin、NPPartiesPlugin、NPChiselPlugin、NPColiseumPlugin 和 NPProjectPlugin(主要游戏玩法插件)正常运行所强制依赖的组件。
作为服务器管理员,你无需直接配置此项——它会通过依赖它的插件自动完成配置。
同时支持 PaperMC 和原版 Spigot —— 仅限 Paper 的功能(如向附近玩家实时同步自定义方块)会优雅降级,而非必须要求。

| 功能 |
对你的益处 |
| 统一配置 |
所有配置文件集中存放在单个 plugins/NorrionProject/ 文件夹中 |
| YAML/SQL 存储 |
持久化数据,可选择文件后端或数据库后端 |
| 多语言支持 (EN/FR) |
已翻译的消息,可扩展至更多语言 |
| 分页命令 |
整洁的 /help 命令,支持页面导航 |
| 服务器 ↔ 客户端中继 |
与 Fabric 客户端模组通信(HUD、地图等)预告功能 :3 |
| 按模组版本检查 |
仅当玩家实际过时的 Norrion 模组需要更新时才会提示,踢出屏幕上会列出预期版本 —— 未安装这些模组的玩家永远不会被踢出 |
| 插件感知的客户端模组 |
客户端模组仅在服务器运行了对应的插件时才启用其功能 |
| Vault 经济 API |
自动检测你的经济插件 |
| 自定义方块管理工具 |
逐区块检查、移除或写入由任何 Norrion 插件放置的自定义方块 |
| FastAsyncWorldEdit 集成 |
自定义方块(凿子变体、建筑等)在 //copy、//paste 和结构图操作后得以保留 —— 所有需要此功能的 Norrion 插件均可共享使用 |

- 下载
NorrionProjectCorePlugin-<version>.jar
- 将其放入
plugins/ 目录
- 重启服务器(请勿使用
/reload)
plugins/NorrionProject/ 文件夹将自动创建
生成的文件
plugins/NorrionProject/
├── core-config.yml # 全局配置(语言、SQL 等)
├── language/ # 翻译文件
└── <other norrion project plugins files>/ # 每个依赖插件会创建其子文件夹
⚙️ 配置 (config.yml)
所有文档均提供于 plugins/NorrionProject/core-config.yml 中。
提示:在小型/中型服务器上,请保持 use-sql: false(YAML 文件 = 零配置,自动保存)。

| 命令 |
描述 |
权限 |
/npcore plugins [page] |
列出所有已安装的 Norrion 插件及其版本,以及客户端模组所需的版本 |
norrion.core.admin |
/npcore customblock chunk [page] |
列出你当前所在区块放置的自定义方块,支持可点击的分页导航(类似 /help) |
norrion.core.admin |
/npcore customblock target |
显示你正看向的方块的自定义数据(命名空间、ID、位置、世界) |
norrion.core.admin |
/npcore customblock remove <x> <y> <z> |
移除指定坐标处的自定义方块数据 |
norrion.core.admin |
/npcore customblock write <namespace:id> |
强制将你正看向的方块写入为指定的自定义方块类型(调试工具) |
norrion.core.admin |
? 依赖项
| 插件 |
类型 |
原因 |
| Vault |
可选 |
经济系统(若存在则自动检测) |
| NPCore (包含) |
内部 |
共享数据模型 |
问:我安装了但它没有任何反应?
答:正常!这是一个库。安装一个依赖它的插件(例如 NPEnderChestPlugin)即可看到游戏功能。
问:我可以把它用于我自己的插件吗?
答:不建议这样做。它是专门为 NorrionProject 生态系统构建的,可能会发生剧烈变化,从而导致代码维护困难。至少目前是这样。
问:如何更改语言?
答:编辑 config.yml 中的 locale: "en",然后重启服务器。
没有哪个插件能开箱即用地适合所有服务器。如果你需要某项功能、与其他插件的集成或某些调整,且在此处未找到,欢迎前往 Discord 告诉我们——这正是本插件不断完善的动力所在。

属于 Norrion 服务器 生态的一部分。
NorrionProjectCorePlugin
The core of the NorrionProject ecosystem — Required for all NorrionProject plugins
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.

| 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 |
| Per-mod version check |
Players are only asked to update the Norrion mods that are actually outdated, with the expected version listed on the kick screen — players without the mods are never kicked |
| Plugin-aware client mods |
Client mods only enable their features when their own plugin runs on the server |
| 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 |

- 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).

| Command |
Description |
Permission |
/npcore plugins [page] |
Lists every installed Norrion plugin with its version and the client mod version it expects |
norrion.core.admin |
/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 |
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.
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.

- Website & Wiki: norrion.eu
- Support / Bugs: Norrion Discord
Part of the Norrion server ecosystem.
评论 0
登录后参与评分
还没有评论,来抢沙发吧