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 世界更“活”，这个模组会带来两种完全不同的体验：

- 月末的不确定事件，让生存过程更有悬念

- 可制作的诱饵系统，让你能主动决定要引来什么

想要更多家畜，就准备果蔬诱饵。

想挑战野兽，就丢下鲜肉诱饵。

想把夜色变成灾难，就试试丢下双份的腐烂诱饵。