这是我为 NeoForge 模组提供的共享开发库。
它包含可复用的系统,否则这些系统需要在每个项目中单独实现。该库有意专注于框架基础设施,而非提供自身的游戏机制。
功能特性
- 数值追踪:具有衰减、阈值、效果、边际递减效应、来源记忆、协同作用和里程碑的持久化玩家数值。
- 通用追踪:用于诸如方块挖掘量、实体击败数、移动距离、机器操作次数及其他数值统计的可复用计数器。
- 分类系统:支持标签、命名空间、关键词、配方、加权信号、覆盖项和排除项的可配置物品分类,以及运行时解析。
- 兼容性:带有模组提供的注册表和配置覆盖项的运行时兼容性定义。
- 资源系统:由 JSON、配置文件和数据包驱动的定定义与覆盖项。
- 动态 UI:可复用组件、可拖拽/调整大小的面板、小部件、通知、渲染工具以及共享的命令中心(Command Center)。
- UI 编辑:模块定位、缩放、可见性、颜色、布局编辑、工具箱及编辑器控制。
- 开发者工具:框架命令、诊断工具、分类追踪以及请求/响应网络通信。
- KubeJS 集成:针对部分框架 API的实验性绑定。
架构设计
MariesLib 分为几个模块:
marie-core:核心 API、追踪、分类、兼容性及共享服务marie-commands:命令与诊断工具marie-resources:基于资源的定义与覆盖项marie-ui:可复用的 UI 基础设施marie-editor:UI 编辑与配置基础设施
该库的设计原则是:使用方模组提供具体的含义和游戏逻辑规则。
例如:
MariesLib::提供通用的数值追踪功能。 Nourished::定义营养值及其对玩家的影响方式。
兼容性与 API
MariesLib 针对 Minecraft 1.21.1 / NeoForge 21.1.x / Java 21。
该库使用明确的 API 稳定性等级:
@Stable:适用于外部使用@Experimental:可用但可能发生变更@Internal:实现细节,不打算供外部使用
MariesLib 作为普通的 NeoForge 依赖项分发,未通过 Jar-in-Jar 方式捆绑。
许可证: LGPL-3.0-only
源码: GitHub 文档: API Reference 更新日志: CHANGELOG.md
This is a shared development library for my NeoForge mods.
It contains reusable systems that would otherwise have to be implemented separately in each project. It is intentionally focused on framework infrastructure rather than providing its own gameplay mechanics.
What it provides
- Value tracking: persistent player values with decay, thresholds, effects, diminishing returns, source memory, synergies, and milestones.
- Generic tracking: reusable counters for things such as blocks mined, entities defeated, distance traveled, machine operations, and other numeric statistics.
- Classification: configurable item classification with tags, namespaces, keywords, recipes, weighted signals, overrides, exclusions, and runtime resolution.
- Compatibility: runtime compatibility definitions with mod-provided registrations and configuration overrides.
- Resource systems: JSON, configuration, and datapack-driven definitions and overrides.
- Dynamic UI: reusable components, draggable/resizable panels, widgets, notifications, rendering utilities, and the shared Command Center.
- UI editing: module positioning, scaling, visibility, colors, layout editing, toolboxes, and editor controls.
- Developer tooling: framework commands, diagnostics, classification tracing, and request/response networking.
- KubeJS integration: experimental bindings for selected framework APIs.
Architecture
MariesLib is split into several modules:
marie-core: core APIs, tracking, classification, compatibility, and shared servicesmarie-commands: commands and diagnostic toolingmarie-resources: resource-driven definitions and overridesmarie-ui: reusable UI infrastructuremarie-editor: UI editing and configuration infrastructure
The library is designed so that consuming mods provides the actual meaning and gameplay rules.
For example:
MariesLib:: provides generic value tracking. Nourished:: defines nutrition values and how they affect the player.
Compatibility & API
MariesLib targets Minecraft 1.21.1 / NeoForge. 21.1.x / Java 21.
The library uses explicit API stability levels:
@Stable: intended for external use@Experimental: usable but subject to change@Internal: implementation detail and not intended for external use
MariesLib is distributed as a normal NeoForge dependency and is not bundled through Jar-in-Jar.
License: LGPL-3.0-only
Source: GitHub Documentation: API Reference Changelog: CHANGELOG.md
下载 MariesLib
下载 MariesLib
下载 MariesLib
下载 MariesLib
下载 MariesLib
下载 MariesLib
下载 MariesLib
下载 MariesLib
下载 MariesLib
下载 MariesLib
物品编辑器
新增
- 全新布局:左侧为小型物品卡片,右侧为可滚动的数值滑块列表
- 文件 / 信息菜单栏:“文件”用于在页面间切换(“数值”页以及模组添加的任何其他页面),“信息”显示物品数值的来源原因
- “保存”和“还原”按钮位于右上角,悬停时高亮显示,点击后闪烁提示“已保存 ✓”或“已还原 ✓”
- 显示物品的合成方式:采用 JEI/EMI 风格的配方网格(工作台、熔炉、烟熏炉、高炉、营火、切石机,安装 Farmer's Delight 和 Dungeon's Delight 模组时会额外显示对应工作站),并带有工作站方块缓慢旋转的 3D 预览
- 原料槽位支持多种物品循环切换;悬停其中一个物品时会显示其名称及所属模组
- 信息标签页现在可读:使用自然语言步骤配合 ✓/✗/⚠ 图标和颜色,替代原始调试输出
- 当物品没有已保存的覆盖值时,滑块将从物品的当前数值开始,而非从 0% 开始
- 长列表(如浏览物品)中的滚动条现在可以通过拖拽来操作
修复
- 窗口不再会被保存到屏幕外,从而避免了编辑器看起来无法打开的问题
- 较高的页面内容不再溢出到窗口底部之外
- 窗口无法被调整到小于其自身内容的尺寸
- “文件”下拉菜单始终绘制在物品图标和名称之上
- 齿轮(样式)弹出窗口不再出现在 JEI/EMI 物品列表的背后
- 可在特殊工作站合成的物品(例如陶罐)会优先显示该工作站,而非工作台
- 工作站预览现在回退显示方块图标,而不是空白显示
- 对未修改的物品点击“保存”不再导致其自动检测到的数值冻结
- 覆盖值现在保存至
config/<modid>/item_editor/,每个食物组一个文件夹,且仅写入实际更改过的数值。现有的覆盖值会自动迁移至此位置。
收益递减
- 新增总开关,可一次性关闭所有食物的收益递减效果
- 关闭再重新开启收益递减不会恢复旧的惩罚,即使在重启期间或玩家离线时也有效
- 豁免收益递减的物品在其工具提示中不再显示“已递减”预览
每个盒子 / Hub
- Hub 侧边栏标签和标题标签的颜色现在可以自定义
- 条形行可以保持其图标大小独立于文本大小
多模组设置
- 当安装两个或多个 MariesLib 模组时,每个模组的自定义颜色将在其各自的文件中加载和保存
- 被模组自身的排除列表排除的物品,即使存在旧的物品编辑器覆盖值,食用时也不再提供数值
面向附加组件开发者
- 为你的自定义界面和 HUD 提供现成的编辑模式:无需针对每个界面编写代码即可移动、调整大小、对齐和拖拽文本/图标/条形图(参见
API.md中的“模块编辑主机”) - 可复用的编辑模式灯光切换小部件
- 界面的第二个副本可以保留其自己的布局、颜色、不透明度和亮度
- Hub 标签页可以托管可编辑布局并接收键盘输入
- 可复用的 Hub 主页:3D 实体预览旁附带可滚动的信息板块
- 收益递减曲线可以按物品设置,并在服务器端和客户端的工具提示中生效
- 物品编辑器页面可以添加自己的界面,认领拖入的物品,并将编辑器跳转至另一个物品
- 小数滑块(如“293.15 K”)以及选项面板中具有实时标签的按钮
- 新增
marie-config模块:一个支持 JSON 导出/导入的配置注册表(目前尚无 UI) - 配置注册现在会在启动后关闭,与其他 MariesLib 功能保持一致
- 新增公共
RenderContexts辅助函数,方便你在自己的界面中使用 MariesLib 渲染功能
MariesLib 0.1.2-beta
这是一个重大的 Beta 版本。模块面板获得了全面的外观和体验重构,并行运行的模组得到了大量修复,之前无法工作的几个数据包和 API 功能现在已可用。
⚠️ 更新前必读
- Beta 版本。
- 插件开发者:部分 UI 类已移动。 布局编辑器、模块设置、缩放配置和工具箱系统已从
marie-ui移出,现位于新的marie-editor模块中。如果你使用了其中任何功能,请添加该依赖项。 - 即将移除的弃用项: 单参数形式的
registerExportResolver(ExportResolver)。请使用接受注册表键的重载方法。
亮点
- 每个面板上的发光和脉冲选项卡: 文本、边框和条形图支持颜色和强度的发光效果,以及“呼吸”式边框脉冲(平滑、心跳或闪烁),且多个面板间保持同步。
- 更多面板样式设置: 背景和不透明度、边框阴影、标题大小,以及一键“重置此模块”按钮。
- 更多隐藏选项: 在“隐藏图标”旁边新增了“隐藏窗口”、“隐藏文本”、“隐藏条形图”和“隐藏标题”。
- 尺寸吸附: 调整面板大小时可吸附到相邻面板的尺寸。
- 新的 Hub 窗口: 一个带侧边栏的可调整大小弹出窗口,被诸如 Nourished 的饮食屏幕编辑器等编辑器使用。
- 重新设计的颜色选择器: 圆形色相/饱和度轮盘、亮度滑块、收藏的颜色以及十六进制输入框。
修复
多个模组同时使用 MariesLib
- 每个模组现在拥有独立的衰减、效果、工具提示、阈值和追踪设置。此前,最后加载的模组的设置会应用到所有模组上。
- 进食或使用资源源时,在安装多个模组的情况下不再重复计算价值增益。
- 使用默认设置的模组不再导致其他模组的工具提示和价值预估出现在每个物品上。
- 重生不再清除设置为“死亡保留数值”的模组的近期资源历史,且每个模组都会重置为其各自的初始等级。
- 单人游戏中的物品工具提示不再显示你上次加入多人服务器时遗留的价值信息。
游戏性和追踪
- 由模组添加的个人资料、里程碑和协同效应不再在第二次
/reload后消失。 - 每日、每周和每月追踪器在你过夜睡眠或使用
/time命令时会正确重置。因时间倒流而缩短的周期会记录其实际结束时间。 - 递减回报现在能正确计算“免费口数”。
- 修复了进食时 HUD 全屏黑屏闪烁的问题。
数据包和脚本
tracking_profiles/*.json文件现已正常加载。此前它们始终被跳过。- 包含批量物品到价值映射的兼容条目现在能应用这些映射。
- 运行时工具提示消息覆盖现在仅替换指定的消息,而非整个物品的工具提示。
- 模组扫描:名称相似的两个扫描器不再互相覆盖缓存结果。
- 移除了未使用的
mod_compat.json加载器,该加载器此前每次启动时都会记录缺失资源的警告。
面板和编辑器
- 条形图行和图例现在尊重其各自的文本、图标和条形图大小滑块以及“隐藏窗口”设置。
- 图标大小不再在不应该跟随的地方跟随文本大小(卡路里、平衡、近期餐食、多吃点)。
- 移动面板不再有粘滞感。仅在靠近另一个面板时才会吸附。
- 发光效果不再将面板的圆角变直角。
- Hub 颜色选择器现已正常工作,自定义标题颜色会应用于侧边栏。
- 移动轮廓现在覆盖面板的标题区域,且图标面板会跟随其图标移动。
- 所有面板中一次只能打开一个尺寸设置窗口。
- 工具箱滚动条不再遮挡十六进制值和滑块百分比。
面向插件开发者
新模块:marie-editor
布局编辑器、模块设置、缩放配置和工具箱系统已从 marie-ui 迁移至此。如果你使用了这些功能,请添加依赖项。
API 稳定性
所有 dev.marie.framework 包现在均标记为 @Stable(稳定)、@Experimental(实验性)或 @Internal(内部)。
- 稳定: 价值追踪、事件与定义、兼容性、标签审计、资源同步
- 实验性: UI、数据包、扫描器、命令和配置系统
API 新增内容
MarieAPI.registerTrackerMilestone(请改用此方法,而非直接使用TrackerMilestoneRegistry)MarieRequestChannelMarieModScanMarieWidgets,MarieToolbox,MarieModuleSettingsMariePulse,AnimatedFloatHubPanelBarRowComponent,TitleBarComponent,LegendComponentRenderContext#drawRoundedRect,#drawGlow,#drawEffectIconValueDefinition.icon和.tags
弃用项
registerExportResolver(ExportResolver)现标记为forRemoval,将在下一个主版本中移除。请使用接受注册表键的重载方法。
已在 API.md 中记录
marie_schema_version契约:共用一个版本,版本不匹配仅发出警告。- 哪些注册项在
/reload后保留:个人资料、里程碑、追踪器里程碑和协同效应会保留。追踪器和颜色必须重新注册。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧