TFC Event Extension
An expansion mod that adds "end-of-month events" and "bait-triggered active events" to TerraFirmaCraft.
This mod makes the world stop running like clockwork. On the last day of every month, you may receive an unexpected visit; and if you're willing to set up bait, you can lure animals, beasts, or even monsters directly to your location.
This mod introduces two event systems:
1. Passive Events: Auto-triggered at Month's End
On the last day of each month, the system automatically selects 1 random online player and triggers 1 event near them. A server-wide notification is sent before the event, with entities spawning after a 30-second delay.
Default probabilities:
- Livestock Event: 20%
- Beast Event: 50%
- Monster Event: 30%
2. Active Events: Triggered by Placing Bait
You can craft and place bait, which activates after a set time to lure target creatures. Bait becomes a visible block on the ground and is consumed upon activation. In the current version, bait activates after 30 in-game minutes by default.
Passive Event Details
A. Livestock Event
Spawns a group of breedable TFC livestock near the player.
Creature pool:
Cow, Goat, Yak, Sheep, Alpaca, Musk Ox, Chicken, Duck, Quail, Pig, Rabbit
Default parameters:
- Spawn count: 2–4
- Spawn distance: 16–32 blocks
- Guaranteed at least: 1 male + 1 female
- Spawn point bonus drop: 1–2 random TFC crop seeds or fruit tree saplings
B. Beast Event
Spawns a group of hostile beasts on the player's perimeter.
Beasts are divided into 3 categories:
- Bears: 1–2
- Big Cats: 2–3
- Pack Predators: 4–6
Possible creatures include:
Polar Bear, Grizzly Bear, Black Bear, Cougar, Panther, Lion, Sabertooth, Tiger, Wolf, Hyena, Dire Wolf
Default parameters:
- Spawn distance: 40–60 blocks
- Spawns only on natural terrain surface when possible
- Spawned beasts will attempt to track nearby players
C. Monster Event
Spawns a group of enhanced monsters near the player.
Current version rules:
- Nighttime: spawns melee skeletons or zombies
- Daytime: spawns spiders or creepers
Default parameters:
- Night skeletons: 3–5
- Night zombies: 4–6
- Day spiders: 3–5
- Day creepers: 2–3
- Spawn distance: 40–60 blocks
Additional traits:
- All event monsters wear a set of random TFC armor
- Skeletons use TFC stone axes, becoming melee units
Bait System
A. Fruit & Vegetable Bait
Purpose:
- Attracts livestock
- Triggers an enhanced livestock event
Cooldown: 24 in-game days
Crafting recipe:
- Outer ring: 8 any fruits or vegetables
- Center: 1 Glue
B. Fresh Meat Bait
Purpose:
- Attracts beasts
- Triggers an enhanced beast event
Cooldown: 16 in-game days
Crafting recipe:
- Outer ring: 8 any raw meat
- Center: 1 Glue
C. Rotten Flesh Bait
Purpose:
- Attracts monsters
- Triggers an enhanced monster event
Cooldown: 12 in-game hours
Crafting recipe:
- Outer ring: 8 rotten flesh materials
- Center: 1 Glue
Enhanced Event Details
A. Enhanced Livestock Event
When fruit & vegetable bait activates:
- Randomly spawns 2 types of livestock
- 4–6 of each type
- Still guarantees male/female pairing
- Bonus drops increased to: 3–5 random seeds or fruit tree saplings
B. Enhanced Beast Event
When fresh meat bait activates:
- Still randomly selects from bears / big cats / pack predators
- Quantities are doubled
Default enhanced ranges:
- Bears: 2–4
- Big Cats: 4–6
- Pack Predators: 8–12
C. Enhanced Monster Event
When rotten flesh bait activates, multiple groups of monsters spawn at once:
- Melee Skeletons: 4–6
- Zombies: 8–10
- Baby Zombies: 2
- Creepers: 2–3
- Spiders: 3–5
Special rule:
If 2 or more rotten flesh baits are ready simultaneously, the entire monster roster spawns an additional round — effectively doubling the total.
D. Bait Rules
- Beast bait and monster bait can activate simultaneously
- Animal bait can only activate alone
- If animal bait activates at the same time as beast/monster bait, the animals will be scared off — only beast or monster events will be processed
- If no valid player is nearby when bait activates, the bait expires and disappears
- Placed bait can be picked up by right-clicking
- In non-creative mode, breaking bait also drops the corresponding bait item
Event Entity Behavior
All entities spawned through events have additional tracking logic:
- They attempt to move toward or lock onto the nearest player
- If they fail to approach a player within 1 TFC in-game hour AND no player is within 16 blocks, they are automatically removed to prevent long-term accumulation
Configurable Parameters
Configuration file location: serverconfig/tfceventextension-server.toml
Passive Event Parameters:
- animalChance = 0.2 — Livestock event probability
- beastChance = 0.5 — Beast event probability
- animalSpawnMinRange = 16 — Livestock minimum spawn distance
- animalSpawnMaxRange = 32 — Livestock maximum spawn distance
- beastSpawnMinRange = 40 — Beast/Monster minimum spawn distance
- beastSpawnMaxRange = 60 — Beast/Monster maximum spawn distance
- notificationDelayTicks = 600 — Delay from notification to actual spawn (default 30 seconds)
Active Event Parameters:
- animalBaitCooldownDays = 24 — Fruit & vegetable bait cooldown
- beastBaitCooldownDays = 16 — Fresh meat bait cooldown
- monsterBaitCooldownHours = 12 — Rotten flesh bait cooldown
Note: In the current version, the monster passive event probability is the "remaining probability" — i.e., 1 - animalChance - beastChance.
Admin Debug Commands
Admin-only commands:
- /tfcevent trigger animal — Immediately trigger a normal animal event
- /tfcevent trigger beast — Immediately trigger a normal beast event
- /tfcevent trigger monster — Immediately trigger a normal monster event
- /tfcevent trigger_enhanced animal — Immediately trigger an enhanced animal event
- /tfcevent trigger_enhanced beast — Immediately trigger an enhanced beast event
- /tfcevent trigger_enhanced monster — Immediately trigger an enhanced monster event
- /tfcevent status — View current event status and bait cooldowns
- /tfcevent reset_cooldowns — Reset all bait cooldowns
Summary
If you want your TFC world to feel more "alive," this mod brings two completely different experiences:
- End-of-month random events that add suspense to survival
- A craftable bait system that lets you decide what to attract
Want more livestock? Prepare fruit & vegetable bait.
Want to challenge beasts? Drop some fresh meat bait.
Want to turn the night into a disaster? Try dropping a double helping of rotten bait.
群峦事件拓展 / TFC Event Extension
一个为 TFC增加“月末事件”与“诱饵主动事件”的扩展模组。
这个模组会让世界不再只是按部就班地运转。
每个月的最后一天，你都可能迎来一次意外来客；而如果你愿意主动布置诱饵，也可以把动物、野兽，甚至怪物直接引到自己附近。
本模组加入两套事件机制：
1. 被动事件：月末自动触发
每个月最后一天，系统会自动从在线玩家中随机选择 1 名目标玩家，并在其附近触发 1 次事件。
事件触发前会先向全服发送提示，延迟 30 秒后正式生成实体。
默认概率：
- 牲畜事件：`20%`
- 野兽事件：`50%`
- 怪物事件：`30%`
2. 主动事件：放置诱饵触发
你可以制作并放置诱饵，等待其生效后主动引来目标生物。
诱饵会在地面上变成可见的诱饵方块，生效后自动消耗。
当前版本中，诱饵默认会在游戏时间30 分钟后生效。
被动事件内容
A牲畜事件
会在玩家附近生成一群可繁殖的 TFC 家畜。
生物池：
牛、山羊、牦牛、绵羊、羊驼、麝牛、鸡、鸭、鹌鹑、猪、兔子
默认参数：
- 生成数量：`2-4`
- 生成距离：`16-32` 格
- 至少保证：`1 公 + 1 母`
- 刷新点额外掉落：`1-2` 个随机 TFC 作物种子或果树树苗
B野兽事件
会在玩家外围生成一群主动威胁你的野兽。
野兽分为 3 类：
- 熊类：`1-2`
- 猫科猛兽：`2-3`
- 群猎型掠食者：`4-6`
可能出现的生物包括：
- 北极熊 - 灰熊 - 黑熊 - 美洲狮 - 黑豹 - 狮子 - 剑齿虎 - 老虎 - 狼 - 鬣狗 - 恐狼
默认参数：
- 生成距离：`40-60` 格
- 只会尽量生成在自然地表
- 生成后会尝试追踪附近玩家
C怪物事件
会在玩家附近生成一组强化怪物。
当前版本规则：
- 夜晚：生成近战骷髅或僵尸
- 白天：生成蜘蛛或苦力怕
默认参数：
- 夜晚骷髅：`3-5`
- 夜晚僵尸：`4-6`
- 白天蜘蛛：`3-5`
- 白天苦力怕：`2-3`
- 生成距离：`40-60` 格
附加特性：
- 所有事件怪物都会穿戴一套随机 TFC 护甲
- 骷髅会使用 TFC 石斧，变成近战单位
诱饵系统诱饵类型
A果蔬诱饵
用途：
- 吸引牲畜
- 触发强化版牲畜事件
冷却：
- `24` 个游戏日
合成方式：
- 外圈 `8` 个任意水果或蔬菜
- 中心 `1` 个 胶水
B鲜肉诱饵
用途：
- 吸引野兽
- 触发强化版野兽事件
冷却：
- `16` 个游戏日
合成方式：
- 外圈 `8` 个任意生肉
- 中心 `1` 个 胶水
腐肉诱饵
用途：
- 吸引怪物
- 触发强化版怪物事件
冷却：
- `12` 个游戏小时
合成方式：
- 外圈 `8` 个腐肉材料
- 中心 `1` 个 胶水
当前版本中，腐肉诱饵实际支持的材料为：
强化事件内容
A强化牲畜事件
果蔬诱饵生效后：
- 随机生成 `2` 种牲畜
- 每种数量：`4-6`
- 仍保证至少有公母搭配
- 额外掉落提升为：`3-5` 个随机种子或果树树苗
B强化野兽事件
鲜肉诱饵生效后：
- 仍然从熊类 / 猫科 / 群猎者中随机选一类
- 数量直接翻倍
默认强化后范围：
- 熊类：`2-4`
- 猫科：`4-6`
- 群猎者：`8-12`
C强化怪物事件
腐肉诱饵生效后，会一次性生成多组怪物：
- 近战骷髅：`4-6`
- 僵尸：`8-10`
- 小僵尸：`2`
- 苦力怕：`2-3`
- 蜘蛛：`3-5`
特殊规则：
- 如果同时有 `2` 个或以上腐肉诱饵一起就绪，整套怪物数量会再来一轮，相当于翻倍
D诱饵规则说明
- 野兽诱饵和怪物诱饵可以同时生效
- 动物诱饵只能单独生效
- 如果动物诱饵和野兽/怪物诱饵同时生效，动物会被惊跑，只会结算野兽或怪物事件
- 诱饵生效时，如果附近没有可用玩家，诱饵会直接失效并消失
- 放在地上的诱饵可以右键捡回
- 非创造模式下直接打掉，也会掉回对应诱饵物品
事件实体行为
所有通过事件生成的实体都会带有额外追踪逻辑：
- 会尝试朝最近的玩家移动或锁定目标
- 如果在 `1` 个 TFC 游戏小时内都没有接近玩家
- 并且 `16` 格内始终没有玩家
- 这些实体会自动清理，避免长期堆积
当前版本可配置参数
配置文件位置：
`serverconfig/tfceventextension-server.toml`
以下为当前版本已经实际生效的主要参数：
## 被动事件参数
- `animalChance = 0.2`
牲畜事件概率
- `beastChance = 0.5`
野兽事件概率
- `animalSpawnMinRange = 16`
牲畜最小生成距离
- `animalSpawnMaxRange = 32`
牲畜最大生成距离
- `beastSpawnMinRange = 40`
野兽/怪物最小生成距离
- `beastSpawnMaxRange = 60`
野兽/怪物最大生成距离
- `notificationDelayTicks = 600`
提示到正式刷新的延迟，默认 30 秒
## 主动事件参数
- `animalBaitCooldownDays = 24`
果蔬诱饵冷却
- `beastBaitCooldownDays = 16`
鲜肉诱饵冷却
- `monsterBaitCooldownHours = 12`
腐肉诱饵冷却
说明：
- 当前版本中，怪物被动事件的实际概率为“剩余概率”
- 也就是 `1 - animalChance - beastChance`
# 管理员调试命令
仅管理员可用：
- `/tfcevent trigger animal`
- `/tfcevent trigger beast`
- `/tfcevent trigger monster`
立即按普通事件流程触发。
- `/tfcevent trigger_enhanced animal`
- `/tfcevent trigger_enhanced beast`
- `/tfcevent trigger_enhanced monster`
立即按强化事件流程触发。
- `/tfcevent status`
查看当前事件状态与诱饵冷却
- `/tfcevent reset_cooldowns`
重置所有诱饵冷却
总结
如果你想让 TFC 世界更“活”，这个模组会带来两种完全不同的体验：
- 月末的不确定事件，让生存过程更有悬念
- 可制作的诱饵系统，让你能主动决定要引来什么
想要更多家畜，就准备果蔬诱饵。
想挑战野兽，就丢下鲜肉诱饵。
想把夜色变成灾难，就试试丢下双份的腐烂诱饵。
