community contract

Community Contracts add a new feature to Stardew Valley, where townspeople offer contracts for farmers to invest in. You can obtain goods that can be sold for a profit, processed into refined products, or used in crafting.

Community Contract

🌟 **Welcome to the community contract module! ** This mod brings new business opportunities to daily life in Stardew Valley, allowing you to establish closer economic ties with the townspeople.

🎯 Core Functions

Community contracts introduce an innovative mechanism: the residents of Stardew Valley offer various business contracts in which you, the farmer, can invest. By accepting the contract, you will receive a variety of goods that can:

• 💰 **Sell for profit** - Earn gold coins by selling directly
• 🛠️ **Processing and refining** - Made into more valuable products
• 🎁 **Used in Crafting** - As a raw material for other items

🚀 Version 1.1.0 update

📍 Custom delivery location

Now you can choose custom delivery locations from the community contract menu! How to operate:

• Move the farmer to any tile on the map
• Click "Set placements" in the menu
• The selected tile will be highlighted and the delivery box will appear at this location
• ✅ Supports original maps indoors and outdoors, compatible with custom maps and extensions

🎨 Personalization

• **Delivery Box Color** - You can choose different color boxes when the goods are delivered
• **Highlight Color** - Select the placement highlight color
• **Text Color** - Color of the text label above the placement
• All color settings can be adjusted via GMCM or config.json file

⚡ Convenient functions

• **Quick Teleport** - Left-click the character portrait in the menu to immediately teleport to the character's location
• **Tooltips** - Menu items now show detailed descriptions

🤝 Detailed explanation of contract system

💖 Friendship Level Mechanism

Each community member's "level" is determined by the number of friendship points with the player:

• Each accepted contract increases friendship points
• Friendship level increases → Contract size expands, product quality and value increase
• The farmer's professional skill level (agriculture, fishing, etc.) will also affect the contract size

🎯 Professional division of labor

Many vanilla NPCs have areas of expertise that offer contracts for specific items:

• **Professional NPC** - Provides raw materials and refined products (based on the number of processors set by the farmer)
• **Common NPC** - Provides more general products, as well as recycled products based on the number of recycling machines
• **Strategy Choice** - Decide how many processors to make and which NPCs to prioritize based on your playstyle

⚙️ Configuration options

⌨️ Shortcut key settings

• **Quick Menu Hotkeys** - Quick access to contract conversations (off by default)
• **Instant Delivery Hotkey** - Deliver all pending contracts immediately

🏠 Character settings

• **NPC offer pop-up window** - Contract offer is displayed after the conversation (enabled by default)
• **Cooling Time** - Waiting time after contract is provided (default 60 game minutes)
• **Contract value percentage** - 70% for professional NPCs, 80% for others (the higher the percentage, the lower the profit but the more friendship points)
• **Item quantity multiplier** - Higher value means more raw materials (does not affect the quantity of refined products)

🎮Installation Instructions

• Install the latest version of SMAPI
• Unzip the module folder to the Stardew Valley/Mods directory
• Run the game using SMAPI

💡 **TIP**: By interacting with the townspeople, you will come to know their areas of expertise and the types of processors they operate. Reasonably plan the sequence of processor production and NPC development to build your own business empire!