特性
核心特性
- 基于时间的锻造 - 配方需要真实时间才能完成,离线时也会继续计算
- 渐进式升级 - 随着等级提升,解锁更多的锻造槽和时间加成
- 多个锻造槽 - 最多支持 5 个并发锻造槽(通过升级解锁)
- 燃料系统 - 需要基于熔岩的燃料系统来驱动熔炉
- 自定义配方 - 可通过配置文件或游戏内命令完全配置配方
- 分类管理 - 将配方组织到自定义类别中
- 进度追踪 - 可视化进度条和剩余时间显示
- 自动领取通知 - 当物品准备好时,玩家会收到通知
集成特性
- ItemsAdder 支持 - 完全兼容 ItemsAdder 自定义物品
- 自定义模型数据 - 支持资源包的自定义模型数据 (Custom Model Data)
- 持久化数据 - 所有进度保存并在重启后持续存在
生活便利
- 批量领取 - 一次性领取所有已完成的物品
- 材料检查 - 可视化反馈,显示你是否拥有所需的材料
- 时间格式化 - 易读的时间显示(例如:1小时30分45秒)
- Tab 补全 - 所有命令均支持完整的 Tab 键补全
- 热重载 - 无需重启服务器即可重新加载配置
安装
- 下载 Forging999 插件 JAR 文件
- 将其放入服务器的
plugins 文件夹中
- 启动或重启你的服务器
- 插件将生成默认配置文件
- (可选)安装 ItemsAdder 以支持自定义物品
命令
玩家命令
| 命令 |
描述 |
/forge |
打开主熔炉图形界面 (GUI) |
/forge help |
显示包含所有可用命令的帮助菜单 |
管理员命令
| 命令 |
描述 |
/forge reload |
重新加载插件配置 |
/forge settime <player> <seconds> |
设置玩家的总锻造时间 |
/forge setlevel <player> <level> |
设置玩家的熔炉等级(1-5) |
配方管理命令
| 命令 |
描述 |
/forge recipe add <category> <item> <lava_cost> <time> <materials> |
添加新配方 |
/forge recipe remove <category> <recipe_name> |
从类别中移除配方 |
/forge recipe list |
列出所有配方类别 |
/forge recipe list <category> |
列出特定类别中的所有配方 |
类别管理命令
| 命令 |
描述 |
/forge category add <name> [display_name] [icon] |
创建新的配方类别 |
/forge category remove <name> |
删除配方类别 |
/forge category list |
列出所有可用类别 |
配方添加命令详细用法
/forge recipe add <category> <hand|item_id> <lava_cost> <forge_time> <materials>
参数:
category - 要添加配方的类别(必须已存在)
hand|item_id - 使用 "hand" 表示使用手持物品,或指定物品 ID
lava_cost - 燃料成本,单位为毫桶 (mb)
forge_time - 时间,单位为秒或格式化的字符串(如 1h, 30m, 1h30m)
materials - 所需原料(逗号分隔)
示例:
/forge recipe add ores hand 500 3600 RAW_IRON:1
/forge recipe add parts DIAMOND_SWORD 800 1h30m DIAMOND:2,STICK:1
/forge recipe add custom ia:myitems:sword 600 2h IRON_INGOT:4,DIAMOND:2
权限
| 权限 |
描述 |
默认值 |
forging999.use |
允许访问熔炉 GUI |
所有玩家 |
forging999.admin |
允许访问管理员命令 |
操作员 |
熔炉系统
主界面
熔炉界面是一个包含 54 个格子的 GUI,其中包括:
- 熔炉槽(最多 5 个) - 中央格子,用于进行锻造
- 计时器显示 - 显示每个活跃配方的剩余时间
- 燃料指示器 - 显示当前熔岩燃料量
- 升级按钮 - 显示等级进度和升级要求
- 配方浏览器 - 按类别访问所有可用配方
- 领取按钮 - 快速领取所有已完成的物品
熔炉槽状态
- 锁定 - 尚未解锁的槽位(需要更高的熔炉等级)
- 空 - 可用于新配方的槽位
- 活跃 - 正在锻造中(显示进度条和剩余时间)
- 已完成 - 待领取(带有完成指示器高亮显示)
锻造流程
- 点击一个空的熔炉槽
- 选择一个配方类别
- 选择一个配方(必须拥有原料和燃料)
- 消耗原料和燃料
- 等待计时器完成
- 领取你锻造出的物品
升级系统
概述
熔炉升级系统奖励使用熔炉的玩家。随着玩家花费更多时间进行锻造,他们将解锁额外的槽位和时间减少加成。
等级进阶
| 等级 |
熔炉槽 |
时间减免 |
所需锻造时间 |
| 1 |
1 个槽 |
0% |
初始等级 |
| 2 |
2 个槽 |
10% |
累计 20 分钟 |
| 3 |
3 个槽 |
20% |
累计 40 分钟 |
| 4 |
4 个槽 |
30% |
累计 60 分钟 |
| 5 |
5 个槽 |
40% |
累计 120 分钟 |
升级机制
- 锻造时间会在配方完成时累积
- 每个完成配方的总时间都会计入你的进度
- 满足要求时会自动升级
- 进度将在 GUI 中的升级按钮上显示
- 时间减免适用于所有后续配方
时间减免加成
时间减免加成随每个等级叠加:
- 等级 1:配方耗时为基础时间的 100%
- 等级 2:配方耗时为基础时间的 90%
- 等级 3:配方耗时为基础时间的 80%
- 等级 4:配方耗时为基础时间的 70%
- 等级 5:配方耗时为基础时间的 60%
配方系统
配方组件
每个配方由以下部分组成:
- 结果物品 - 锻造完成时生成的物品
- 原料 - 开始时消耗的所需材料
- 锻造时间 - 基础所需时间(受等级加成影响)
- 燃料成本 - 消耗的熔岩燃料,单位为毫桶 (mb)
配方分类
为了方便浏览,配方被组织为不同的类别:
- 默认类别:部件(Parts)、矿石(Ores)、盔甲(Armor)
- 可以通过命令或配置文件添加自定义类别
- 每个类别都有显示名称和图标
在游戏中添加配方
使用手持物品:
/forge recipe add ores hand 500 1h RAW_GOLD:2,COAL:4
使用材料名称:
/forge recipe add parts IRON_PICKAXE 800 2h IRON_INGOT:3,STICK:2
使用 ItemsAdder 物品:
材料格式
原版物品:
- 格式:
MATERIAL_NAME:AMOUNT
- 示例:
IRON_INGOT:3
ItemsAdder 物品:
- 格式:
ia:namespace:item_id:amount
- 示例:
ia:myitems:custom_ore:2
多种材料:
- 用逗号分隔
- 示例:
IRON_INGOT:3,DIAMOND:2,STICK:1
时间格式
配方支持多种时间格式:
- 秒:
3600(1 小时)
- 小时:
1h 或 2h
- 分钟:
30m 或 45m
- 组合:
1h30m 或 2h15m30s
燃料系统
概述
熔炉需要岩浆燃料才能运行。每个配方都会消耗特定数量的燃料,单位为毫桶(mb)。
添加燃料
- 手持岩浆桶并点击燃料槽
- 或者将岩浆桶拖拽到燃料槽上
- 每个岩浆桶增加 1000mb 的燃料
- 添加燃料后会返还空桶
燃料消耗
- 开始配方时会消耗燃料
- 不同配方所需的燃料量不同
- 如果燃料不足,则无法启动配方
- 燃料数量会在图形用户界面中显示
燃料成本
每种配方的燃料成本都是可配置的。默认示例如下:
- 简单冶炼:100-200 mb
- 标准锻造:300-600 mb
- 高级锻造:800-1000+ mb
ItemsAdder 集成
概述
Forging999 完全支持 ItemsAdder 自定义物品,可用于:
- 配方结果(锻造出的物品)
- 配方原料(所需材料)
- 类别图标
使用 ItemsAdder 物品
在命令中:
ia:namespace:item_id 或 itemsadder:namespace:item_id
示例:
/forge recipe add weapons ia:myweapons:fire_sword 1000 2h ia:myores:fire_crystal:3
/forge category add gems Gems ia:myitems:gem_icon
在配置文件中:
result:
itemsadder_id: "namespace:item_id"
amount: 1
自动检测
插件会自动检测是否安装了 ItemsAdder
自定义物品会被正确识别和处理
物品保留所有自定义属性(名称、描述、模型数据)
配置
文件位置
plugins/Forging999/config.yml - 主配置文件
plugins/Forging999/data.yml - 玩家数据(自动管理)
forge_settings:
每个等级可用的槽位数量
slots_per_level:
1: 1
2: 2
3: 3
4: 4
5: 5
超过等级 1 后,每级减少的时间百分比
time_reduction_per_level: 10
每个等级所需的锻造时间(秒)
upgrade_requirements:
2: 1200 # 20 分钟
3: 2400 # 40 分钟
4: 3600 # 60 分钟
5: 7200 # 120 分钟
recipe_categories:
category_name:
display_name: "显示名称"
icon:
material: "MATERIAL_NAME"
name: "&7图标名称"
recipes:
recipe_name:
result:
material: "结果材料"
name: "&f物品名称"
amount: 1
lore:
- "&7描述行"
custom_model_data: 12345
time_in_seconds: 3600
fuel_cost: 500
ingredients:
ingredient_1:
material: "MATERIAL_NAME"
amount: 3
recipes:
custom_sword:
result:
itemsadder_id: "mynamespace:epic_sword"
amount: 1
time_in_seconds: 7200
fuel_cost: 1000
ingredients:
custom_ingot:
itemsadder_id: "mynamespace:magic_ingot"
amount: 4
diamond:
material: "DIAMOND"
amount: 2
常见问题解答
离线时锻造会继续吗?
是的!即使你离线,锻造也会按实时进行。当你回来时,物品就可以领取了。
如果我的背包已满,领取时会发生什么?
你会收到背包已满的消息。物品会保留在熔炉槽位中,直到你有空间领取为止。
我可以取消正在进行的配方吗?
不行,一旦配方开始,就无法取消。原料和燃料已经被消耗。
如果服务器重启,我会失去进度吗?
不会,所有进度都会自动保存,并在服务器重启后保留。
如何添加来自 ItemsAdder 的自定义物品?
在命令中使用 ia:namespace:item_id 格式,或在配置文件中使用的 itemsadder_id。
我可以拥有超过 5 个熔炉槽位吗?
默认最大值为 5 个槽位,但这可以在配置中进行修改。
时间减少效果是否适用于正在进行中的配方?
不,时间减少仅适用于升级后新开始的配方。
我如何删除默认配方?
使用 /forge recipe remove <category> <recipe_name> 或删除配置文件中的相关部分。
我可以创建没有原料的配方吗?
可以,将原料数量设置为 0 或省略原料部分(但仍需要燃料)。
如果我从配置中移除正在进行的配方会发生什么?
正在进行的配方会正常完成,但该配方将不再可用于新的锻造。
支持
如有问题、建议或贡献,请加入我的 Discord
Features
Core Features
- Time-Based Forging - Recipes take real time to complete, continuing even when offline
- Progressive Leveling - Unlock more forge slots and time bonuses as you level up
- Multiple Forge Slots - Up to 5 concurrent forging slots (unlocked through leveling)
- Fuel System - Lava-based fuel system required to power the forge
- Custom Recipes - Fully configurable recipes via config or in-game commands
- Category Organization - Organize recipes into custom categories
- Progress Tracking - Visual progress bars and time remaining displays
- Auto-Claim Notification - Players are notified when items are ready
Integration Features
- ItemsAdder Support - Full compatibility with ItemsAdder custom items
- Custom Model Data - Support for resource pack custom model data
- Persistent Data - All progress saved and persists through restarts
Quality of Life
- Batch Claiming - Claim all completed items at once
- Ingredient Checking - Visual feedback showing if you have required materials
- Time Formatting - Human-readable time displays (1h 30m 45s)
- Tab Completion - Full tab completion for all commands
- Hot Reload - Reload configuration without server restart
Installation
- Download the Forging999 plugin JAR file
- Place it in your server's
plugins folder
- Start or restart your server
- The plugin will generate default configuration files
- (Optional) Install ItemsAdder for custom item support
Commands
Player Commands
| Command |
Description |
/forge |
Opens the main forge GUI |
/forge help |
Displays the help menu with all available commands |
Admin Commands
| Command |
Description |
/forge reload |
Reloads the plugin configuration |
/forge settime <player> <seconds> |
Sets a player's total forging time |
/forge setlevel <player> <level> |
Sets a player's forge level (1-5) |
Recipe Management Commands
| Command |
Description |
/forge recipe add <category> <item> <lava_cost> <time> <materials> |
Adds a new recipe |
/forge recipe remove <category> <recipe_name> |
Removes a recipe from a category |
/forge recipe list |
Lists all recipe categories |
/forge recipe list <category> |
Lists all recipes in a specific category |
Category Management Commands
| Command |
Description |
/forge category add <name> [display_name] [icon] |
Creates a new recipe category |
/forge category remove <name> |
Deletes a recipe category |
/forge category list |
Lists all available categories |
Recipe Add Command Detailed Usage
/forge recipe add <category> <hand|item_id> <lava_cost> <forge_time> <materials>
Parameters:
category - The category to add the recipe to (must exist)
hand|item_id - Use "hand" to use held item, or specify item ID
lava_cost - Fuel cost in millibuckets (mb)
forge_time - Time in seconds or formatted (1h, 30m, 1h30m)
materials - Required ingredients (comma-separated)
Examples:
/forge recipe add ores hand 500 3600 RAW_IRON:1
/forge recipe add parts DIAMOND_SWORD 800 1h30m DIAMOND:2,STICK:1
/forge recipe add custom ia:myitems:sword 600 2h IRON_INGOT:4,DIAMOND:2
Permissions
| Permission |
Description |
Default |
forging999.use |
Allows access to the forge GUI |
All players |
forging999.admin |
Allows access to admin commands |
Operators |
Forge System
Main Interface
The forge interface is a 54-slot GUI containing:
- Forge Slots (5 max) - Central slots where forging takes place
- Timer Display - Shows remaining time for each active recipe
- Fuel Indicator - Displays current lava fuel amount
- Upgrade Button - Shows level progress and upgrade requirements
- Recipe Browser - Access to all available recipes by category
- Claim Button - Quickly claim all completed items
Forge Slot States
- Locked - Slot not yet unlocked (requires higher forge level)
- Empty - Available for a new recipe
- Active - Currently forging (shows progress bar and time remaining)
- Complete - Ready to claim (highlighted with completion indicator)
Forging Process
- Click an empty forge slot
- Select a recipe category
- Choose a recipe (must have ingredients and fuel)
- Ingredients and fuel are consumed
- Wait for the timer to complete
- Claim your forged item
Leveling System
Overview
The forge leveling system rewards players for using the forge. As players spend more time forging, they unlock additional slots and time reduction bonuses.
Level Progression
| Level |
Forge Slots |
Time Reduction |
Required Forging Time |
| 1 |
1 slot |
0% |
Starting level |
| 2 |
2 slots |
10% |
20 minutes total |
| 3 |
3 slots |
20% |
40 minutes total |
| 4 |
4 slots |
30% |
60 minutes total |
| 5 |
5 slots |
40% |
120 minutes total |
How Leveling Works
- Forging time is accumulated as recipes complete
- The total time of each completed recipe adds to your progress
- Upgrades happen automatically when requirements are met
- Progress is shown on the upgrade button in the GUI
- Time reduction applies to all future recipes
Time Reduction Bonus
The time reduction bonus stacks with each level:
- Level 1: Recipes take 100% of base time
- Level 2: Recipes take 90% of base time
- Level 3: Recipes take 80% of base time
- Level 4: Recipes take 70% of base time
- Level 5: Recipes take 60% of base time
Recipe System
Recipe Components
Each recipe consists of:
- Result Item - The item produced when forging completes
- Ingredients - Required materials consumed when starting
- Forge Time - Base time required (affected by level bonus)
- Fuel Cost - Lava fuel consumed in millibuckets (mb)
Recipe Categories
Recipes are organized into categories for easy browsing:
- Default categories: Parts, Ores, Armor
- Custom categories can be added via commands or config
- Each category has a display name and icon
Adding Recipes In-Game
Using held item:
/forge recipe add ores hand 500 1h RAW_GOLD:2,COAL:4
Using material name:
/forge recipe add parts IRON_PICKAXE 800 2h IRON_INGOT:3,STICK:2
Using ItemsAdder item:
Material Format
Vanilla Items:
- Format:
MATERIAL_NAME:AMOUNT
- Example:
IRON_INGOT:3
ItemsAdder Items:
- Format:
ia:namespace:item_id:amount
- Example:
ia:myitems:custom_ore:2
Multiple Materials:
- Separate with commas
- Example:
IRON_INGOT:3,DIAMOND:2,STICK:1
Time Format
Recipes support multiple time formats:
- Seconds:
3600 (1 hour)
- Hours:
1h or 2h
- Minutes:
30m or 45m
- Combined:
1h30m or 2h15m30s
Fuel System
Overview
The forge requires lava fuel to operate. Each recipe consumes a specific amount of fuel measured in millibuckets (mb).
Adding Fuel
- Hold a lava bucket and click the fuel slot
- Or drag a lava bucket onto the fuel slot
- Each lava bucket adds 1000mb of fuel
- Empty bucket is returned after adding fuel
Fuel Consumption
- Fuel is consumed when starting a recipe
- Different recipes require different fuel amounts
- If insufficient fuel, the recipe cannot be started
- Fuel amount is displayed in the GUI
Fuel Costs
Fuel costs are configurable per recipe. Default examples:
- Simple smelting: 100-200 mb
- Standard forging: 300-600 mb
- Advanced forging: 800-1000+ mb
ItemsAdder Integration
Overview
Forging999 fully supports ItemsAdder custom items for:
- Recipe results (forged items)
- Recipe ingredients (required materials)
- Category icons
Using ItemsAdder Items
In Commands:
ia:namespace:item_id or itemsadder:namespace:item_id
Examples:
/forge recipe add weapons ia:myweapons:fire_sword 1000 2h ia:myores:fire_crystal:3
/forge category add gems Gems ia:myitems:gem_icon
In Config:
result:
itemsadder_id: "namespace:item_id"
amount: 1
Automatic Detection
The plugin automatically detects if ItemsAdder is installed
Custom items are recognized and handled appropriately
Items maintain all custom properties (name, lore, model data)
Configuration
File Locations
plugins/Forging999/config.yml - Main configuration
plugins/Forging999/data.yml - Player data (auto-managed)
forge_settings:
Slots available at each level
slots_per_level:
1: 1
2: 2
3: 3
4: 4
5: 5
Time reduction percentage per level above 1
time_reduction_per_level: 10
Forging time (seconds) required for each level
upgrade_requirements:
2: 1200 # 20 minutes
3: 2400 # 40 minutes
4: 3600 # 60 minutes
5: 7200 # 120 minutes
recipe_categories:
category_name:
display_name: "Display Name"
icon:
material: "MATERIAL_NAME"
name: "&7Icon Name"
recipes:
recipe_name:
result:
material: "RESULT_MATERIAL"
name: "&fItem Name"
amount: 1
lore:
- "&7Description line"
custom_model_data: 12345
time_in_seconds: 3600
fuel_cost: 500
ingredients:
ingredient_1:
material: "MATERIAL_NAME"
amount: 3
recipes:
custom_sword:
result:
itemsadder_id: "mynamespace:epic_sword"
amount: 1
time_in_seconds: 7200
fuel_cost: 1000
ingredients:
custom_ingot:
itemsadder_id: "mynamespace:magic_ingot"
amount: 4
diamond:
material: "DIAMOND"
amount: 2
Frequently Asked Questions
Does forging continue when I'm offline?
Yes! Forging continues in real-time even when you're offline. Your items will be ready to claim when you return.
What happens if my inventory is full when claiming?
You'll receive a message that your inventory is full. The item remains in the forge slot until you have space to claim it.
Can I cancel a recipe in progress?
No, once a recipe starts, it cannot be cancelled. Ingredients and fuel have already been consumed.
Do I lose progress if the server restarts?
No, all progress is saved automatically and persists through server restarts.
How do I add custom items from ItemsAdder?
Use the ia:namespace:item_id format in commands or itemsadder_id in config files.
Can I have more than 5 forge slots?
The default maximum is 5 slots, but this can be modified in the configuration.
Does the time reduction apply to recipes already in progress?
No, time reduction only applies to newly started recipes after leveling up.
How do I remove the default recipes?
Use /forge recipe remove <category> <recipe_name> or delete them from the config file.
Can I create recipes with no ingredients?
Yes, set ingredient amounts to 0 or omit the ingredients section (still requires fuel).
What happens to active recipes if I remove them from config?
Active recipes will complete normally, but the recipe won't be available for new forging.
Support
For issues, suggestions, or contributions, please join my discord
评论 0
登录后参与评分
还没有评论,来抢沙发吧