# Kakamora: C🥥c🥥nut Carvers

Haeri Kim (20254236) | [git.prototyping.id/20254236/homework5](https://git.prototyping.id/20254236/homework5)



### Table of Contents
- [Concept Overview](#concept-overview)
- [Core Mechanic: Carving](#core-mechanic-carving)
- [Progression System](#progression-system)
- [Tribe and Combat Phase](#tribe-and-combat-phase)
- [Win and Lose Conditions](#win-and-lose-conditions)
- [Key Controls](#key-controls)

---

## Concept Overview
> *Inspired by the Kakamora from Disney **Moana**. Tiny coconut warriors who go absolutely wild at sea.*
![Moana](assets/Moana.jpg)

A **first-person crafting and survival game** where you carve 🥥 coconuts into warriors, weapons, and tools. The better you carve, the stronger your tribe. Get enough crew together and they sail out to sea and then things get wild.

![Kakamora Warriors](assets/Kakamora.webp)


> *Visual tone ref: Kakamora from Moana (2016)*

---

## Core Mechanic: Carving

![Coconut](assets/Coconut-cutting.webp)

You see your **hands holding a knife**, cutting a coconut straight off the tree. Something similar to *Fruitninja.*
![Fruitninja](assets/fruitninja-1.jpg.webp)


### 🗡️ Knife Sharpness

Knife starts out **dull and slow**. Carving is a bit of a struggle at first.
Level up and the blade gets **sharper and snappier.**

```
bladeLevel = 1        -> slow drag, rough edges
bladeLevel = 5        -> smooth arc, clean cuts
bladeLevel = MAX      -> one-swipe precision
```

### Facial Expressions and Accessories

How fast you carve changes what the Kakamora looks like:

| Carving Speed | Face Expression | Accessories |
|:---:|:---:|:---:|
| Slow | Blank stare | Plain coconut shell |
| Medium | Determined | Tiny painted markings |
| Fast | Fierce grin | War paint + bone trinkets |
| Ultra Fast | Battle-ready | Full armor + war crown |

---

## Progression System

1. **Start** - Grab a coconut off the tree (first-person knife action)
2. **Carve** - Shape it up. Carving speed decides warrior quality
3. **Level Up Knife** - Sharper blade = faster and cleaner carves
4. **Craft Arrows** - Once the tribe is big enough, start carving **poison arrows** for sea combat

| Name | Reference |
|:---:|:---:|
| Face | ![Face](assets/face.webp) ![Faces](assets/face2.png) |
| Arrow | ![Arrow](assets/arrow.png) |

```

if (tribeSize >= 10):
    unlockPhase("ocean_voyage")
    beginCrafting("toxic_arrows")
```

> **Toxic arrow carving** is its own minigame -- you need good timing or the poison goes to waste

---

## Tribe and Combat Phase

![Moana Ocean](assets/Moana.jpg)

### Setting Sail

Once you have **10+ Kakamora** carved and ready, the whole group **heads out to sea**.
Enemies start showing up.

### Ocean Battle

- Warriors fight with the **arrows you made**
- You keep crafting from the boat to resupply on the fly

### Retreat

If **more than half the tribe goes down** at sea:

```
if (survivors < tribeSize / 2):
    triggerRetreat()
    returnToLand()
    // back to square one -> harvest new coconuts from trees
```

---

## Win and Lose Conditions

| Condition | Outcome |
|:---|:---|
| Tribe makes it through ocean combat | **Win** |
| Over half the tribe dies at sea | **Retreat** |
| Whole tribe wiped out | **GAME OVER** |

---

## Key Controls

All **keyboard-based**:

| Key | Action |
|:---:|:---|
| `W A S D` | Move / navigate |
| `Space` | Grab coconut from tree |
| `← →` | Carving stroke direction |
| `E` | Confirm / finish carve |
| `Q` | Switch to arrow crafting mode |