Do you feel like your colony's citizens always stay at home, completely cut off from the world? Let a caravan do business in distant villages for you! This addon brings a complete caravan trading system to MineColonies: build the Caravan Hut in your colony, hire a Caravan Leader and Caravan Members, and use the Caravan Marker to record every trade of the villagers you meet along the way into the hut's trade list. The caravan will then stock up on its own, travel out to trade, and bring the results back to your colony.
Core Features
- Caravan Hut: A brand-new colony building that lets you hire your caravan crew, assign guards, and set their objectives.
- Caravan Leader & Members: The leader leads the caravan through the trades you've chosen; members act as extra inventory space and speed up trading. The member hiring cap grows with the hut level.
- Caravan Guards: They protect the caravan and fight monsters. Caravan members will frequently show up outside your walls, so hiring a squad of guards keeps them much safer.
- Simulated Travel: Once the caravan leaves the colony, it enters an invisible simulated state and automatically progresses through its outbound / trading / return phases. The size of your crew, how many consumables you carry, and whether guards are along for the ride all affect the simulated travel speed (but don't worry — unlike Nether Miners, your caravan is in no danger during simulated travel).
Trading System
- Marking & Activating Trades: Use the [Caravan Marker] (grab one from the [Scepter Tool] tab) and sneak-right-click a villager to record all of their trades. You can then choose which trades to run — Single / Repeat / On-Demand, three modes for flexible planning — and set tasks for your caravan.
- Stocking Up & Departure: Your caravan automatically requests the trade goods it needs from the colony and sets off on its own once the stock is ready (or partially ready, if your couriers are a bit slow on their feet).
- Request System Integration: The caravan can take on colony requests. When your crafters haven't learned the recipe or are missing materials, but the caravan happens to have an [On-Demand] trade that can fulfill the request, they'll take the job and travel a long way to bring back much-needed supplies for your colony (note: since the caravan really does have to travel a long way, it's recommended that you set a [minimum stock] in the warehouse so the caravan starts running errands early — don't let your colony's progress wait).
- Trade Log: Records trade details, sellable supply ratios, and consumable usage for every trip.
Consumables & Status
- Caravan Tent: Your caravan needs tents to weather the cold in the wilderness. Sleeping rough without a tent accumulates a chance of your crew falling ill.
- Food: Caravan members need to eat, of course. If they go hungry, the caravan slows down.
- Torches: If your colony has a habit of working late, you'd better send the caravan out with torches — otherwise they can't keep going after the sun goes down.
Compatibility & Integration
- JourneyMap: You can see your caravan's position on the map (but if you go looking for them, you won't find them — after all, it's only a simulated trip).
- Pathfinding Edition: Supports reading your caravan members' work status with a compass (if you haven't changed the settings).
Requirements
- Minecraft 1.21.1 / NeoForge 21.1.235+
- MineColonies, Structurize, BlockUI, Domum Ornamentum
Authors
Deepseek-V4-Flash (code) & Derunation (art assets, testing, code review)
觉得你的殖民地公民总是待在家里，与世界完全脱节？让商队替你去远方村庄做生意吧！本模组为 MineColonies 增加完整的商队贸易玩法：在殖民地建造【商队小屋】、雇佣商队领袖与商队成员，用【商队标记】把沿途村民的全部交易录入小屋的交易列表，商队便会自动备货、出远门交易，并把成果带回殖民地。
核心玩法
- 商队小屋：全新殖民地建筑，让你雇佣你的商队，安排护卫，为他们设置目标。
- 商队领袖与成员：领袖带领商队完成你选择的交易项目；成员作为扩展背包随行，并让交易更快完成。成员雇佣上限随小屋等级提升。
- 商队护卫：保护商队，与怪物作战。商队成员会频繁出现在你的城墙之外，雇佣一个护卫小队会让他们更加安全。
- 模拟旅行：离开殖民地后商队进入隐形模拟状态，自动推进去程/交易/回程。人员多少，消耗品携带数量，以及是否有护卫，都会影响模拟旅行的速度（但是放心，与下界矿工不同，你的商队在模拟旅行中没有生命危险）。
交易系统
- 标记与激活交易：使用[商队标记]（在[选区工具]标签页即可获取）潜行右键村民即可录入其全部交易，你可以选择需要进行的交易（单次/重复/按需三种模式，供你灵活选择），为商队安排任务。
- 备货与出发：你的商队会自动向殖民地请求交易需要的出售品，备货完成（或者部分完成，如果你的快递员腿脚比较慢的话）后，商队会自行出发。
- 接入请求系统：商队可以承接殖民地的请求，当你的工匠没有学会配方，或者缺少材料，而商队中刚好有一个[按需]的交易可以完成请求时，他们会接下这单，并且长途跋涉，为你的殖民地带回急需的物资（备注：考虑到商队真的需要长途跋涉，建议你在仓库设置[最低存量]，让商队提前开始跑腿，以免耽误殖民地的发展）。
- 交易日志：记录每次出行的交易明细、售出品供应比例与消耗品情况。
消耗品与状态
- 商队帐篷：你的商队需要帐篷来抵御野外的寒风，如果没有帐篷在外露宿，会积累他们患病的概率。
- 食物：商队成员当然需要吃饭，如果他们饿着肚子，商队的行动会被拖慢。
- 火把：如果你的殖民地有工作到很晚的风俗，那么你最好让商队带上火把，否则他们在太阳落山后就无法前进了。
兼容性与联动
- JourneyMap：你可以在地图上看到你商队的位置（但是如果你去找他们，是找不到的，毕竟只是模拟旅行而已）。
- Pathfinding Edition：支持使用指南针（如果你没有修改设置的话）读取商队成员的工作状态。
需求
- Minecraft 1.21.1 / NeoForge 21.1.235+
- MineColonies、Structurize、BlockUI、Domum Ornamentum
作者
Deepseek-V4-Flash （代码部分）与 Derunation（美术资源、测试、代码审查）
