WIP BEEginner Dungeon

[thmsndk]

This is a WIP issue where I intend to fletch out a beginner level dungeon with bees as the theme, current writing on mobile, so my editing is limited :p

Motivation

• a low tier dungeon that is simpler with less gear requirements than crypt
• learn how to make a dungeon and document it for others to make new content

Goals

• Teach how to use a key to enter a dungeon
• Tracking instance id
• joining instance id with multiple characters
• differences between passive and aggressive mobs perhaps?
• swarm mechanic from spike?

The development of the bee dungeon is happening in the following branch on my personal fork https://github.com/kaansoral/adventureland/compare/main...thmsndk:adventureland:feature/bee_dungeon it contains a few things about devcontainers it should not contain, so once it is ready / in a release candidate state. I'll make a PR from a more clean branch :)

Dungeon Description

Map

Core Design

• Your characters spawns at the entrance
  • it is horizontal to keep the range close to the queen so the queen can be detected easily in parent.entities to keep it simple for new players
• The entrance is guarded by some initial bees, theese bees are roaming and do not respawn
  • Real honey bee nests have workers guarding the entrance, so I felt this made sense.
• Queen Bee is located in the middle of the room
  • Spawns 1..2 worker bees every 8s at a random spawn location (S1,S2,S3,S4), a random player that has attacked the queen is chosen to be the target
  • We spawn them at one of the locations so there is a longer travel time from the location they spawn to the player that is targeted to give players time to react to being terrified
  • Spawns 0..1 drone bees every 20s at a position near the queen, a random player that has attacked the queen is chosen to be the target

Tileset

honey_bee_nest tileset by thmsn

• [ ] Horizontal hexagon walls
  • [ ] Gap / Entrance
  • [ ] "Ceiling" tile for the last wall
  • [ ] "Top" tile for a wall placed in the middle or at the bottom
• [ ] diagonal hexagon walls
• [ ] Vertical hexagon walls
• [ ] Vertical walls
• [ ] Floor
• [ ] Door / Entrance
• [ ] larvae cells
• [ ] animated honey drops
• [ ] honey flowing out of cell, both static and animated
• [ ] bee statue for entrance?
• [ ] spawn place markings

Balance Points

• Worker Bees, Drone Bees

  • How often should they spawn
  • How many should spawn?
  • How much health should it have?
  • How much attack?

• Queen

  • hp? attack?

• Should spawned minions target the same player, or be spread over more players?

• Should Worker bees be spawned at the same spawn point or spread over each spawn point?

Mechanics still being considered

• Worker is a supporter like Elena and heals the queen
• Worker has a Sting ability that has a high chance to kill the worker bee

Mechanics not being considered for a beginner dungeon

• respawning of mobs like xmagex
  • queen would lay eggs, after N time a larvae would emerge, after N time a bee would emerge

How to enter

You can craft a key to enter the dungeon. Recipe is subject to change but should consist of basic mob drops. N x bee wings + N x slime core + more?

Monsters

Queen Bee

Spawns minion bees at an interval. The minions could be random or spawned in specific pairs

Minion Bees

• worker bee that heals the queen?
• soldier bee that attacks the player?
• others?

Upon killing the queen a reward is granted. Should killing minion bees give / drop anything? What rewards should be dropped from Queen? What about xp and gold?

New Items

TODO describe the new honey items names,stats and everything is WIP and might change Snippet to explore existing gear by type

console.dir(
  Object.entries(G.items).reduce((acc, [itemName, item]) => {
    acc[item.type] = acc[item.type] || {};
    acc[item.type][itemName] = Object.fromEntries(
      Object.entries(item).sort(([a], [b]) => a.localeCompare(b))
    );
    return acc;
  }, {}),
  { depth: null }
);

Misc

id	name	type	note
honeykey	-	key
honey	-	material
propolis	-	material
wax	-	material

Consumeable

id	name	type	note
honeyelixir	-	elixir	a/r piercing + sugarrush
honeypot	-	pot	heals both mp & hp, craftable, drops

Equipable

What is extra_stat?	id	name	type	note
honeybelt	-	belt	A stats belt that gives less stat than a dedicated stat belt? gives stats based on class? stats belts gives 4 stat and 3 on compund
honeycape	-	cape	should be worse than cape? there is no early game cape. cape gives 10 armor, 8 resist, 4 stat base, upgrade = 0.1 stat, 2 armor, 1 resist
honeyorb	-	orb	stat orb? 4, upgrade 3, + ability?
honeyhelmet	-	helmet	worse than heavy, better than basic? 5-25 armor, 6-28 resistance, 1-3 stat. upgrade 1 stat, 0.5-5.5 armor, 0.5-5.5 resist
honeychest	-	chest	8-42 armor 6-28 resistance 1-3 stat, upgrade 1 stat, 0.5-5.5 armor / resistance
honeypants	-	pants	7-35 armor, 4-21 resistance, 1-3 stat, upgrade same as chest
honeyboots	-	shoes	3-14 armor 1-3 stat 5-7 speed, upgrade 1 stat, 0.5 - 5.5. armor, 0.625 - 1.125 speed, 0-2.75 resistance
honeygloves	-	gloves	6-28 armor 6-28 armor 3-14 resistance 1-3 stat, upgrade same as chest
honeyearring	-	earring	stat earrings, like belt?
honeyering	-	ring	stat rings? like belt? gives 2 stat, compound 2
honeycomb	-	shield	slows attacker? can we debuff, like dreturn?
honeyamulet	-	amulet	hmm? aura? gold?

Offhand for mages? Quiver for rangers? (honey jar with arrows in it?) Weapons? Honey/propolis/wax coated stinger?

Tracktrix Achievements

• other mobs have small increments of mp /hp for 10/100
  • 10 kills gives 5 hp for bee and goo
  • 100 kills gives 10 hp for crab, goo
• mp is pretty usefull for all levels of the game
• xp is another trait that could be useful for any stage of player.
• maybe even some small incriment of crit like .25 so a newer player will realize how worthwhile it is to seek out

  
  const achievementsByStatAndKills = Object.entries(G.monsters)
  .flatMap(([monsterKey, monster]) =>
  (monster.achievements || []).map(([kills, type, stat, amount]) => ({
    monsterKey,
    kills,
    type,
    stat,
    amount,
  }))
  )
  .reduce((acc, achievement) => {
  acc[achievement.stat] = acc[achievement.stat] || {};
  acc[achievement.stat][achievement.kills] = acc[achievement.stat][achievement.kills] || {};
  acc[achievement.stat][achievement.kills][achievement.monsterKey] = (acc[achievement.stat]?.[achievement.kills]?.[achievement.monsterKey] || 0) + achievement.amount;
  return acc;
  }, {});

console.dir(achievementsByStatAndKills);

### Queen (WIP)
```python
"achievements":[
  [1,"stat","hp",5],
  [5,"stat","mp",5],
  [10,"stat","xp",1],
  [50,"stat","armor",5],
  [1000,"stat","gold",1],
  [2500,"stat","crit",0.25],
  # [10000,"stat","attack",2],
  # [100000,"stat","apiercing",2],
  # [1000000,"stat","attack",3],
  # [10000000,"stat","xp",1],
]

Worker (WIP)

"achievements":[
  [25,"stat","hp",5],
  [50,"stat","mp",5],
  [1000,"stat","gold",0.5],
]

Drone (WIP)

"achievements":[
  [25,"stat","hp",5],
  [50,"stat","mp",5],
  [1000,"stat","gold",0.5],
]

---

Misc old ideas & Notes

We need to determine what the dungeon should teach the new players.

I'd like to teach them to use keys, keys could be craftable from bee drops, so you are not afraid to use them like I was first time I got a crypt key

What mechanics should there be? Should it be combat focused? Perhaps multiple modes, either 1 chosen at random or multiple phases?

• one helping bees build their hive by gathering / producing /crafting honey
• another one defending the hive against wasps?
• bee queen with waves of worker bees you have to defeat

The modes could also be different tiers of the dungeon that you either unlock or get a new key to upon completion

-Should cutebees spawn in this dungeon? should bee kills in this dungeon count towards the server spawning a cute bee?

Link to discord issue for real-time discussion https://discord.com/channels/238332476743745536/1176224676809293844/1176224676809293844

Scenario 1 - Bee Queen with waves

Entering the dungeon

Currently we have two ideas

• Crafting a key with ordinary bee drops
  • N x Bee Wings + A stinger? or perhaps just the bee wings.
• No Key required to enter the instance (perhaps some limit on how many instances you can make)
  • Killing the Hive drops a Queen Bee Key that allows you to enter the Queen Bee room

Phase 1

A Hive that spawns bees, this is a swaming mechanic, and you will probably die in the long run if you don't kill the hive. Upon killing the Hive Phase 2 starts perhaps you get a reward / drop for killing the Hive

Phase 2

A Queen Bee emerges from the hive or perhaps you can enter the "Queen Room" Bee Soldier spawns - perhaps you have to kill the soldiers before you can damage the queen, with a larger window than crabx Defeating the queen bee gives drops. This should be the real reward for completing the dungeon

More phases?

Mechanics learned

• A swam mechanic, this prepares you for spike
• Phases - death of hive spawns new mob - prepares you for xmage
• crabx - invulnerability windows

Axioms notes https://discord.com/channels/238332476743745536/259894563047473172/1017907139865485382 There is also a thread I'll try and go trough it and copy notes.

Bee Inspiration https://www.perfectbee.com/learn-about-bees/the-life-of-bees/inside-and-out-of-the-beehive#:~:text=The%20vast%20majority%20of%20the,produce%20little%20flecks%20of%20wax.

https://carolinahoneybees.com/bees-in-a-hive/ https://www.woah.org/en/disease/diseases-of-bees/ https://extension.uga.edu/publications/detail.html?number=B1045&title=honey-bees-and-beekeeping

https://carolinahoneybees.com/bee-anatomy-parts-of-a-bee/ http://www.usfarad.org/honey-bee-biology-basics.html

[thmsndk]

This post will detail the changes that a future PR for the bee dungeon will contain. The WIP diff can be found here https://github.com/kaansoral/adventureland/compare/main...thmsndk:adventureland:feature/bee_dungeon

• the dungeon
  • honey_bee_nest tileset by thmsn
• a guide explaining the dungeon as well as giving hints to tasks relevant for the dungeon
• monsters
  • new queen bee walk animation by thmsn
• npcs

technical enhancements

• potions can now have class or map specific gives data

  • honeypot gives more hp/mp when inside the bee dungeon for example

• You can now configure .enter requirements in maps.py

  • currently crypt and winter_instance is hardcoded, this change allows us to configure it instead of having to hardcode each new instance
  • You can configure items and locations
  • .enter.items is an array of tuples with the item required as well as the amount

    enter: {
    items: [["beekey", 1]], #requires 1 beekey to enter
    }

  • enter.locations is an array of tuples with a list of locations where you have to be near one of them to enter

    "locations": [
    ["main", "spawns", 19, 120], # log near mansion
    ["main", "quirks", 10, 120], # log near mansion
    ["main", "doors", 13, 120] # log near mansion
    ]

  • A future extension could be class or level to enable class specific instances or min/max levels.

• minion spawning

  • the third value in monsters.spawn is an option object where you can configure
  • min and max amount of spawns

  • where they should spawn

    
    "spawns":[
    [10000, "bee_worker", {
            # Spawns 1..2 every 10s at a random spawnPoint ignoring range to the player, targeting a random player that has attacked the boss
        # This is the default behaviour on crypt or crabxx, spawn monsters on players in 400 range
        # "spawnAtPlayer": [400] 
    
        # [point, range] 
        #   point is a list of boundary points where the monsters can spawn, 
        #   range to player for spawning if range is false, range is ignored
        "spawnPoints": [
            [[-237, -941.5, -134.5, -871], False],
            [[244.5, -949, 366.5, -883], False],
            [[-245, -561.5, -95.5, -497], False],
            [[147.5, -567.5, 370, -501.5], False],
        ], 
        "spawnAmount" : [1, 2],
        # "boundary": [[-44.5, -419.5, 40.5, -364]], # TODO: this could limit where they can move
    }], 
    [20000, "bee_drone", {
    # Spawns 0..1 every 20s at the boss ignoring range to the player, targeting a random player that has attacked the boss
        "spawnAtBoss": [False],
        "spawnAmount" : [0, 2],
    }]
    ] ```

• cutebee has a spawn_contributors property used to determine kill contributions for spawning, you can configure monstername and how much score a kill counts for

  • this could be implemented for goldenbat / all monsters instead of being hardcoded.

• show_borders=1 now colors quirks, doors, with a seperate color

  • #FD7188 spawn circle
  • #FC5F39 boundary
  • #5294FF boundaries
  • #916BBD rage
  • #00ff00 quirks
  • #007fff doors
  • #84D5FF bborder / hitAreaColor
  • #FEB222 aborder
  • #54AFFF cborder / base

• WIP endpoint for item balance at /admin/balance/items

• map editor

  • you can now import previously exported map JSON and save it afterwards

• saving a file in design/maps/{map.key}.json will import it to the database on server load if the key does not exist.

• init_game now runs server_bfs for instance maps with npcs or monsters instead of having to hardcode the instance

  • https://github.com/thmsndk/adventureland/blob/bcc0038ecceac571f04caded7e4ee08869def9e1/node/server.js#L381-L399

• fixed exceptions when map key did not exist in the database yet