TFCEventExtension

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

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

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

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

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

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