tarinai/GAME_FEATURES.md

tarinai_ Game Features

This document describes the playable features of tarinai_: what the player sees, what tools do, and how tarinai behave. It is intentionally player/design-facing, not an implementation map.

Game Overview

tarinai_ is an observation sandbox about small creatures called tarinai. The player places food, furniture, hazards, machines, and environment tools, then watches how individuals live, move, eat, sleep, panic, fight, reproduce, get sick, recover, and leave family records.

The core loop is:

1. Choose a field and observe the colony.
2. Place tools or objects that change the environment.
3. Select individual tarinai to inspect health, needs, personality, relations, diseases, records, and current behavior.
4. Watch the event log, colony graphs, and family tree to understand long-term outcomes.

Main UI

• Canvas / field: the main simulation area. Tarinai, items, effects, ants, weather, and terrain are drawn here.
• Top buttons: pause/resume, speed control, ecology guide, sound settings, credits, save, and reset.
• Mobile mode controls: auto, camera, and tool modes for touch screens.
• Right panel tabs: jump between main game, selected tarinai data, tools, colony, events, and family tree.
• Tarinai data panel: appears when a tarinai is selected. Shows health, needs, personality, active effects, relations, inventory, behavior reason, and records.
• Tool palette: grouped buttons for operation, food, medicine, habitat, physics, and danger tools.
• Colony panel: shows population, deaths, colony mood, ground type, and charts for population, needs, and objects.
• Event panel: logs births, deaths, accidents, fights, food events, weather, grass, and relation changes. Optional push-style notifications can be enabled by event type.
• Family tree: shows parent-child generations, inherited stats, personality tags, family links, and archived lineage records.
• Ecology dialog: in-game guide explaining tarinai needs, stress, food, sleep, personality, family, disease, accidents, tools, and colony reading.
• Sound menu: master sound plus voice, notification, and operation categories.

Tool Categories

Operation

• 解除 / clear: cancels the selected tool and returns to normal observe mode.
• たりないデータ / observe: select a tarinai or inspect compatible objects such as signboards.
• 追加 / new: calls a new tarinai into the field.
• つつく / poke: pokes tarinai and can push balls.
• つまむ / pinch: drags tarinai and some placed objects.
• コピー / copy: copies a placed item and pastes a new instance with its settings.
• 戻す / undo and 進む / redo: reverse or reapply placement/edit actions.
• 削除 / delete: removes placed tools, objects, and stains.
• 範囲削除 / area delete: removes many nearby objects or stains around the cursor.
• 洗浄 / water hose: drag to clean dirt, zunchi, corpses, and stains.

Food

• ずんだ餅 / sweet: favored food; can cure some illness.
• へこ餅 / love mochi: makes reproduction behavior more likely for a while.
• けんか餅 / fight mochi: makes fighting behavior more likely for a while.
• 草 / grass: food and comfort source; can grow and be used for simple beds.
• 水滴 / water: drinkable water, also appears during rain and can be set in duplicators.
• ずんだ汁 / zunda juice: clears item effects from a tarinai.
• 複製機 / duplicator: can be loaded with compatible food, medicine, grass, water, pushpins, or oshibyo and then produces or applies that content.

Medicine

• ねむり薬 / sleep drug: causes sleepiness or sleep disease; damage can cure the disease.
• 下剤 / laxative: causes repeated zunchi and reduces food benefit.
• プロテイン / protein: permanent power mode; more damage dealt, lower disease chance.
• ンイテロプ / niteropu: permanent weak mode; less damage dealt, higher disease chance.
• 弾薬 / ammo: temporary high-speed movement and strong collision impact.
• 怪しい薬 / mystery drug: randomly applies an eligible item effect or disease.
• 水銀 / mercury: increases lifespan multiplier on each use.
• 巨大薬 / giant drug: greatly increases size, attack, and speed, but deals ongoing damage.
• 矮小薬 / dwarf drug: greatly decreases size, attack, and speed, and also deals ongoing damage.

Habitat

• ずんち / zunchi: tarinai waste; affects disease and can fertilize grass.
• ロボ掃除機 / robot_cleaner: moves through the field at fixed normal speed 60, or 120 in high-speed mode. It checks the nearest matching cleanup target every 2 seconds, keeps pursuing it between scans, and cleans every matching object it touches. The 死骸 target also covers blood traces; clicking the item opens its target settings.
• 干草寝床 / bed: placeable sleeping spot; helps HP recovery.
• 巣箱 / nest box: reduces stress nearby; improves sleep quality when used.
• ボール / ball: toy that tarinai can play with and the player can poke.
• 看板 / signboard: editable text object; inspect with observe after placing.

Physics

• ヒモ / rope: connect two targets with a flexible link.
• 棒 / rod: connect two targets with a rigid link.
• 柵 / fence: blocks tarinai movement; Q/E rotate by 45 degrees, Shift+Q/E by 5 degrees.
• バウンス柵 / bounce fence: fence that rebounds things that hit it.
• ゲート柵 / gate fence: click to open or close.
• 回転体 / rotator: custom mechanical shape that rotates; click to edit shape and speed.
• 毒ブロック / poison block: custom hazard block; touching it damages skin; click to edit shape.
• 往復体 / reciprocator: custom mechanical shape that moves back and forth; click to edit shape and speed.

Danger

• 石 / stone: heavy object; dangerous when dropped or moved into others.
• げんこつ / genkotsu: large fist impact on the ground.
• 爆竹 / firecracker: creates an explosion.
• 画鋲 / pushpin: rolls when dropped; can lodge in tarinai and cause panic plus continuous damage.
• おしり鋲 / oshibyo: blocks zunchi when lodged; pulling it out releases stored zunchi.
• 射撃 / shoot: attacks with a gun effect.
• アリの巣 / ant nest: spawns ants that search for tarinai and carry them to the nest.

Tarinai Needs And Stats

Tarinai behavior is shaped by health, energy, needs, stress, personality, family, disease, and nearby objects.

Key needs include:

• Food / hunger: hungry tarinai seek grass, sweets, food, water-related options, or other edible targets.
• Sleep: sleepy tarinai seek beds, nest boxes, grass beds, or eventually sleep anywhere.
• Safety: danger, pain, hazards, ants, fights, and panic increase defensive behavior.
• Social / relations: tarinai can seek friends, follow parents, avoid enemies, fight rivals, or approach mates.
• Fulfillment / comfort: toys, ground, sun, shelter, and environment affect mood and stress.
• Health: damage, disease, stress, and recovery decide whether tarinai live, weaken, or die.

Stress changes with fear, crowding, dirt, disease, fights, ground type, and environment. High stress makes fleeing, intimidation, sickness, and poor behavior more likely.

Personality and genetics affect tendencies such as aggression, openness, sociability, nervousness, body size, lifespan, damage, and speed. Some traits are inherited by children and shown in the family tree.

Movement And Behavior

Tarinai are autonomous. Their movement is usually a result of current state, target choice, and local environment.

Common behavior states:

• Idle / wander: waits, watches, or moves lightly around the field.
• Seek food: moves toward edible items when hungry or affected by disease.
• Eat / drink: consumes food, grass, water, medicine, or special items.
• Seek bed / sleep: finds a bed, nest box, grass bed, or sleeps in place.
• Play ball: approaches and interacts with balls.
• Seek material / build: gathers material and creates simple structures such as grass beds.
• Seek friend / follow parent: moves toward social targets or parents.
• Fight / seek enemy: approaches and attacks rivals, especially under fight effects or aggression.
• Panic / flee: runs from danger, pain, destroyed owned objects, hazards, or fear triggers.
• Intimidate: threatens another tarinai or ants instead of directly fleeing or attacking.
• Birth ritual: pre-birth/reproduction interaction with a partner.
• Sunbath: rests in good sun to reduce stress.
• Disease states: zunchi sickness, sleep disease, explosion disease, and injury sickness can override normal priorities.
• Frozen: outside-field preservation state.

Tarinai can be pushed by physics objects, carried or affected by ants, dragged by the player, attached with ropes/rods, blocked by fences, and damaged by hazards. Some objects become owned or emotionally important, so losing them can trigger panic.

Environment

• Field types: park, garden, and cage provide different field sizes.
• Ground types: sand, dirt, concrete, blanket, foot massage, ice, and laboratory-style ground affect stress, grass, and movement.
• Weather: rain and other weather influence water, mood, and environment effects.
• Grass ecology: grass grows, feeds tarinai, comforts them, and can become bed material.
• Dirt and corpses: zunchi, splats, corpses, and ant corpses affect hygiene, disease, and observation results.
• Day/light conditions: lighting and sun influence rendering and sunbath behavior.

Disease And Recovery

Diseases and item effects can strongly redirect behavior.

• Zunchi disease: changes food/water priorities and makes the tarinai feel unwell.
• Sleep disease: causes sleep-focused behavior.
• Explosion disease: creates dangerous explosive outcomes and water-seeking pressure.
• Fight disease / injury sickness: causes unstable movement or fighting-related behavior.
• Item effects: mochi, medicine, size drugs, mercury, ammo, and power modes create temporary or permanent modifiers.

Recovery depends on the disease or effect. Water, rest, food, medicine, zunda juice, damage, environment cleanup, or time can all matter depending on the case.

Family, Records, And Colony Observation

• Tarinai can form parent-child records and partner links.
• Children inherit parts of their parents' tendencies and are grouped by generation.
• Family tree nodes show portraits, inherited stats, personality tags, and relationship structure.
• Event logs record important simulation events such as birth, death, accidents, fights, weather, grass, and relation changes.
• Colony charts summarize population, needs, and object counts over time.
• Selected tarinai records help explain why an individual is acting a certain way.

Save, Reset, And Persistence

• The app supports manual save and restore through browser storage.
• Reset opens field selection and starts a new field state.
• Service worker caching allows the static app shell to remain available after load, depending on browser support.