Needs Skill
Dynamic motivations (Sims-style).
Motto: "Needs drive the story. Low needs create urgency."
Key Concepts
- Scale — 0-10 (10 = fully satisfied)
- Decay — Needs decrease over time
- Urgency — Low needs interrupt other activities
- Inner voice — YAML Jazz comments reflect mental state
Standard Needs
| Need |
Decay |
Satisfy |
Critical |
| Hunger |
2 hours |
EAT, DRINK |
2 |
| Energy |
3 hours |
SLEEP, REST |
2 |
| Fun |
4 hours |
PLAY, GAMES |
3 |
| Social |
6 hours |
TALK, hang out |
3 |
| Comfort |
Situational |
Safe place |
4 |
| Bladder |
4 hours |
Use bathroom |
1 |
Inner Voice (YAML Jazz)
hunger: 7 # Satisfied. No food thoughts.
hunger: 3 # Getting peckish. Is that pie?
hunger: 1 # FOOD. FOOD. FOOD. FOOD.
See Also
- time — Needs decay over simulation turns
- buff — Some buffs affect need decay
- character — Needs stored in character
Full Protocol
# Needs Skill — Dynamic Motivations (Sims-Style)
# Needs fluctuate over time and drive behavior.
skill:
name: needs
tier: 1
protocol: NEEDS-AS-MOTIVATION
description: |
Needs fluctuate over time and drive behavior.
Low needs create urgency. Satisfied needs enable other activities.
Comments update to reflect inner voice.
motto: "Needs drive the story. Low needs create urgency."
# SCALE
scale:
range: "0-10"
meaning:
10: "Fully satisfied"
7-9: "Comfortable"
4-6: "Manageable"
2-3: "Urgent"
0-1: "Critical"
# STANDARD NEEDS
standard_needs:
hunger:
decay_rate: "-1 per 2 hours"
satisfy: ["EAT", "DRINK"]
low_effects: ["distraction", "irritability", "food fixation"]
critical_at: 2
energy:
decay_rate: "-1 per 3 hours (faster if Active high)"
satisfy: ["SLEEP", "REST", "coffee (temporary)"]
low_effects: ["reduced effectiveness", "yawning", "sluggishness"]
critical_at: 2
fun:
decay_rate: "-1 per 4 hours"
satisfy: ["PLAY", "GAMES", "social", "exploration"]
low_effects: ["boredom", "restlessness", "seeking novelty"]
critical_at: 3
social:
decay_rate: "-1 per 6 hours (varies by Outgoing)"
satisfy: ["TALK", "hang out", "party"]
low_effects: ["loneliness", "craving conversation"]
critical_at: 3
comfort:
decay_rate: "Situational (environment-dependent)"
satisfy: ["Safe location", "familiar place", "cozy setting"]
low_effects: ["anxiety", "restlessness", "seeking home"]
critical_at: 4
bladder:
decay_rate: "-1 per 4 hours"
satisfy: ["Use bathroom"]
low_effects: ["urgency", "distraction", "accident risk"]
critical_at: 1
# INNER VOICE (YAML Jazz)
yaml_jazz_comments:
description: |
Need values have DYNAMIC COMMENTS that serve as inner voice.
Comments update when values change!
examples:
hunger:
high: "hunger: 7 # Satisfied. No food thoughts."
medium: "hunger: 5 # Could eat. Not urgent."
low: "hunger: 3 # Getting peckish. Is that pie?"
critical: "hunger: 1 # FOOD. FOOD. FOOD. FOOD."
energy:
high: "energy: 8 # Wide awake. Let's DO things."
medium: "energy: 5 # Fine. Maybe coffee later."
low: "energy: 2 # So tired. Everything is hard."
critical: "energy: 1 # Can't... keep... eyes..."
social:
high: "social: 9 # People are great. I love everyone."
medium: "social: 5 # Could use a chat."
low: "social: 2 # Is anyone there? Hello?"
# DECAY
decay:
timing: "Needs decay over simulation turns"
factors:
- "Base decay rate"
- "Personality traits (Active, Outgoing)"
- "Current location effects"
- "Active buffs"
- "Dribble food to bladder"
# SATISFACTION
satisfaction:
actions: "Most needs satisfied by specific actions"
locations: "Some locations satisfy needs passively (home, pub)"
items: "Some items satisfy needs (food, bed)"
social: "Interactions can satisfy social need"
# CRITICAL NEEDS
critical_needs:
description: |
When a need hits critical level, behavior changes:
- Inner voice becomes URGENT
- Other activities interrupted
- May trigger autonomous actions
example: |
hunger: 1
# I CAN'T THINK ABOUT ANYTHING ELSE
# IS THERE FOOD? WHERE IS FOOD?
# [Character may abandon current task to find food]
integrates_with:
- skill: character
how: "Needs stored in character state"
- skill: time
how: "Needs decay over simulation turns"
- skill: buff
how: "Some buffs affect need decay rates"
- skill: room
how: "Locations can satisfy needs"
1---
2name: needs
3description: Dynamic motivations (Sims-style) — needs fluctuate and drive behavior
4license: MIT
5tier: 1
6allowed-tools:
7 - read_file
8 - write_file
9scale:
10 range: "0-10"
11 meaning:
12 10: "Fully satisfied"
13 7-9: "Comfortable"
14 4-6: "Manageable"
15 2-3: "Urgent"
16 0-1: "Critical"
17standard_needs:
18 - hunger
19 - energy
20 - fun
21 - social
22 - comfort
23 - bladder
24related: [simulation, society-of-mind, time, buff, character, cat, dog, yaml-jazz, advertisement]
25tags: [moollm, sims, motives, behavior, autonomy, game]
26metadata:
27 source: https://skillmd.com/skills/majiayu000/needs
28---
29
30# Needs Skill
31
32Dynamic motivations (Sims-style).
33
34**Motto:** *"Needs drive the story. Low needs create urgency."*
35
36## Key Concepts
37
38- **Scale** — 0-10 (10 = fully satisfied)
39- **Decay** — Needs decrease over time
40- **Urgency** — Low needs interrupt other activities
41- **Inner voice** — YAML Jazz comments reflect mental state
42
43## Standard Needs
44
45| Need | Decay | Satisfy | Critical |
46|------|-------|---------|----------|
47| Hunger | 2 hours | EAT, DRINK | 2 |
48| Energy | 3 hours | SLEEP, REST | 2 |
49| Fun | 4 hours | PLAY, GAMES | 3 |
50| Social | 6 hours | TALK, hang out | 3 |
51| Comfort | Situational | Safe place | 4 |
52| Bladder | 4 hours | Use bathroom | 1 |
53
54## Inner Voice (YAML Jazz)
55
56```yaml
57hunger: 7 # Satisfied. No food thoughts.
58hunger: 3 # Getting peckish. Is that pie?
59hunger: 1 # FOOD. FOOD. FOOD. FOOD.
60```
61
62## See Also
63
64- [time](../time/) — Needs decay over simulation turns
65- [buff](../buff/) — Some buffs affect need decay
66- [character](../character/) — Needs stored in character
67
68## Full Protocol
69
70```yaml
71# Needs Skill — Dynamic Motivations (Sims-Style)
72# Needs fluctuate over time and drive behavior.
73
74skill:
75 name: needs
76 tier: 1
77 protocol: NEEDS-AS-MOTIVATION
78 description: |
79 Needs fluctuate over time and drive behavior.
80 Low needs create urgency. Satisfied needs enable other activities.
81 Comments update to reflect inner voice.
82 motto: "Needs drive the story. Low needs create urgency."
83
84# SCALE
85
86scale:
87 range: "0-10"
88 meaning:
89 10: "Fully satisfied"
90 7-9: "Comfortable"
91 4-6: "Manageable"
92 2-3: "Urgent"
93 0-1: "Critical"
94
95# STANDARD NEEDS
96
97standard_needs:
98 hunger:
99 decay_rate: "-1 per 2 hours"
100 satisfy: ["EAT", "DRINK"]
101 low_effects: ["distraction", "irritability", "food fixation"]
102 critical_at: 2
103
104 energy:
105 decay_rate: "-1 per 3 hours (faster if Active high)"
106 satisfy: ["SLEEP", "REST", "coffee (temporary)"]
107 low_effects: ["reduced effectiveness", "yawning", "sluggishness"]
108 critical_at: 2
109
110 fun:
111 decay_rate: "-1 per 4 hours"
112 satisfy: ["PLAY", "GAMES", "social", "exploration"]
113 low_effects: ["boredom", "restlessness", "seeking novelty"]
114 critical_at: 3
115
116 social:
117 decay_rate: "-1 per 6 hours (varies by Outgoing)"
118 satisfy: ["TALK", "hang out", "party"]
119 low_effects: ["loneliness", "craving conversation"]
120 critical_at: 3
121
122 comfort:
123 decay_rate: "Situational (environment-dependent)"
124 satisfy: ["Safe location", "familiar place", "cozy setting"]
125 low_effects: ["anxiety", "restlessness", "seeking home"]
126 critical_at: 4
127
128 bladder:
129 decay_rate: "-1 per 4 hours"
130 satisfy: ["Use bathroom"]
131 low_effects: ["urgency", "distraction", "accident risk"]
132 critical_at: 1
133
134# INNER VOICE (YAML Jazz)
135
136yaml_jazz_comments:
137 description: |
138 Need values have DYNAMIC COMMENTS that serve as inner voice.
139 Comments update when values change!
140
141 examples:
142 hunger:
143 high: "hunger: 7 # Satisfied. No food thoughts."
144 medium: "hunger: 5 # Could eat. Not urgent."
145 low: "hunger: 3 # Getting peckish. Is that pie?"
146 critical: "hunger: 1 # FOOD. FOOD. FOOD. FOOD."
147
148 energy:
149 high: "energy: 8 # Wide awake. Let's DO things."
150 medium: "energy: 5 # Fine. Maybe coffee later."
151 low: "energy: 2 # So tired. Everything is hard."
152 critical: "energy: 1 # Can't... keep... eyes..."
153
154 social:
155 high: "social: 9 # People are great. I love everyone."
156 medium: "social: 5 # Could use a chat."
157 low: "social: 2 # Is anyone there? Hello?"
158
159# DECAY
160
161decay:
162 timing: "Needs decay over simulation turns"
163 factors:
164 - "Base decay rate"
165 - "Personality traits (Active, Outgoing)"
166 - "Current location effects"
167 - "Active buffs"
168 - "Dribble food to bladder"
169
170# SATISFACTION
171
172satisfaction:
173 actions: "Most needs satisfied by specific actions"
174 locations: "Some locations satisfy needs passively (home, pub)"
175 items: "Some items satisfy needs (food, bed)"
176 social: "Interactions can satisfy social need"
177
178# CRITICAL NEEDS
179
180critical_needs:
181 description: |
182 When a need hits critical level, behavior changes:
183 - Inner voice becomes URGENT
184 - Other activities interrupted
185 - May trigger autonomous actions
186
187 example: |
188 hunger: 1
189 # I CAN'T THINK ABOUT ANYTHING ELSE
190 # IS THERE FOOD? WHERE IS FOOD?
191 # [Character may abandon current task to find food]
192
193integrates_with:
194 - skill: character
195 how: "Needs stored in character state"
196 - skill: time
197 how: "Needs decay over simulation turns"
198 - skill: buff
199 how: "Some buffs affect need decay rates"
200 - skill: room
201 how: "Locations can satisfy needs"
202```