For your second CS Build Week, you and a small team will be competing against your fellow CS students in the Lambda Treasure Hunt. To succeed, you will need to apply knowledge you've learned throughout your entire tenure at Lambda School -- CS, Labs and main track -- to efficiently traverse an island maze, collect treasure, solve puzzles, unearth powerful artifacts and more. Glory and riches await the victors!
Each team must have a minimum of one Backend and one Frontend developer. The responsibilities will be as follows:
As the backend developer, you will be implementing an automated traversal server. By sending POST requests to our LambdaMUD Island server and processing the response, your server will allow your team to move and collect treasure at all hours of the day and night. The teams with efficient traversal and treasure collection algorithms will find themselves prosperous.
As a frontend developer, you will be building a map of the island and implementing an interface to move your characters manually. You may do this by interfacing with your own backend server, connecting directly to the LambdaMUD Island server, or some combination of both (recommended).
Treasure Hunt interface courtesy of Ryan Walker:
The gods presiding over LambdaMUD Island favor beauty and elegance. Those with aesthetic interfaces might find themselves mysteriously blessed with powers throughout the week.
You start the adventure unworthy, unequipped and anonymous. Your first task is to traverse the island and build a map for your personal use. Along the way, you will discover equipment, treasure and clues which will assist you on your quest for power, wealth and glory.
The map is laid out in a grid: Similar to your worlds from Week 1 of your CS training, each room may have exits in the cardinal directions: north, south, east and west. Each room also comes with a unique ID and coordinates for your convenience.
// Starting room
{
"room_id": 0,
"title": "Room 0",
"description": "You are standing in an empty room.",
"coordinates": "(60,60)",
"players": [],
"items": ["small treasure"],
"exits": ["n", "s", "e", "w"],
"cooldown": 60.0,
"errors": [],
"messages": []
}
Your access to the server is restricted until you earn more power. Starting off, you are only allowed to make one request every 60 seconds. Sending another request before that time has elapsed will incur a penalty.
Test your API key with the init command. You can use this to get all relevant stats before you start moving.
curl -X GET -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' https://lambda-treasure-hunt.herokuapp.com/api/adv/init/
This will return the following response:
{
"room_id": 0,
"title": "A Dark Room",
"description": "You cannot see anything.",
"coordinates": "(60,60)",
"exits": ["n", "s", "e", "w"],
"cooldown": 1.0,
"errors": [],
"messages": []
}
All actions are executed via REST API commands to the Lambda Treasure Hunt server. Here is an example movement command:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"direction":"n"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/move/
You will receive an authorization token following successful completion of Friday's Sprint Challenge. This serves as your unique identifier and authentication key. Don't share this key!
The URL will determine the command you are sending to the server.
Note the "direction" parameter, which determines which way you will move.
Your first task is to build your map. Starting from room 0, you can begin to construct a graph of the map:
{0: {"n": "?", "s": "?", "e": "?", "w": "?"}}
Moving North from the starting room will return the following response:
{
"room_id": 10,
"title": "A Dark Room",
"description": "You cannot see anything.",
"coordinates": "(60,61)",
"exits": ["n", "s", "w"],
"cooldown": 100.0,
"errors": [],
"messages": ["You have walked north."]
}
This room has an ID of 10 and contains exits to the north, south and west. Now, you can fill out another entry in your graph:
{
0: {"n": 10, "s": "?", "e": "?", "w": "?"},
10: {"n": "?", "s": 0, "w": "?"}
}
There are a total of 500 rooms so be thoughtful about how you traverse the map. Note that you begin the hunt blind but will gain new powers as the hunt progresses.
An accurate map is the wise explorer's best friend. By predicting the ID of the destination room, you can reduce your action cooldown by 50%. Say you are in room 10 and moving back south to room 0:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"direction":"s", "next_room_id": "0"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/move/
Note the new parameter, next_room_id. Your map tells you that room 0 lies south of room 10. This returns the following response:
{
"room_id": 0,
"title": "A Dark Room",
"description": "You cannot see anything.",
"coordinates": "(60,60)",
"players": [],
"items": [],
"exits": ["n", "s", "e", "w"],
"cooldown": 50.0,
"errors": [],
"messages": ["You have walked south.", "Wise Explorer: -50% CD"]
}
Note the Wise Explorer bonus and 50% cooldown reduction.
You may have noticed the small treasure lying in the room. You can pick it up with the following command:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"name":"treasure"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/take/
You may drop items with the following command:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"name":"treasure"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/drop/
First, you must find the shop. It's not too far from your starting location. Once you do, you can offer your treasure in exchange for gold.
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"name":"treasure"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/sell/
This will return:
{
"room_id": "?",
"title": "Shop",
"description": "You are standing in a shop. You can sell your treasure here.",
"coordinates": "?",
"players": [],
"items": [],
"exits": ["e"],
"cooldown": 2.0,
"errors": [],
"messages": ["I'll give you 100 gold for that Small Treasure.", "(include 'confirm':'yes' to sell Small Treasure)"]
}
Confirm the sale with the following command:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"name":"treasure", "confirm":"yes"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/sell/
You can check your status and inventory using the following command:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" https://lambda-treasure-hunt.herokuapp.com/api/adv/status/
{
"name": "br80",
"cooldown": 2.0,
"encumbrance": 2, // How much are you carrying?
"strength": 10, // How much can you carry?
"speed": 10, // How fast do you travel?
"gold": 400,
"inventory": ["Small Treasure"],
"status": [],
"errors": [],
"messages": []
}
You can examine players or items in your room or inventory using this command:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"name":"[NAME OF ITEM OR PLAYER]"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/examine/
Certain items can be worn on either your feet or your body for boosts in speed and/or power. You may wear items with this command:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"name":"[NAME OF WEARABLE]"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/wear/
You can change your name once you find the name changer using the following command:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"name":"[NEW NAME]"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/change_name/
If you find a shrine, you may pray at the shrine to earn some new powers:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" https://lambda-treasure-hunt.herokuapp.com/api/adv/pray/
Once earning the power of flight, you may use this ability to avoid movement penalties on elevated terrain:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"direction":"n"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/fly/
Once mastering the dash, you may use this ability to cover many rooms in one direction quickly:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"direction":"n", "num_rooms":"5", "next_room_ids":"10,19,20,63,72"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/dash/
Formatting is very important for these commands: next_room_ids must match every room in a straight line and num_rooms must be the exact count for the dash to work successfully.
Once you acquire your true name, you may mine for Lambda Coins using the following API endpoints:
:
Submit a proposed proof and your game token to this endpoint to attempt to mine a block. If successful, you will receive a Lambda Coin.
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"proof":"[new_proof]"}' https://lambda-treasure-hunt.herokuapp.com/api/bc/mine/
Get the last valid proof to use to mine a new block. Also returns the current difficulty level, which is the number of 0's required at the beginning of the hash for a new proof to be valid.
curl -X GET -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' https://lambda-treasure-hunt.herokuapp.com/api/bc/last_proof/
{
"proof": 123456,
"difficulty": 8,
"cooldown": 1.0,
"messages": [],
"errors": []
}
Get your Lambda Coin balance.
curl -X GET -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' https://lambda-treasure-hunt.herokuapp.com/api/bc/get_balance/
{
"cooldown": 1.0,
"messages": ["You have a balance of 35.0 Lambda Coins"],
"errors": []
}
You can spend your Lambda Coins to transform items into powerful equipment at the transmogrifier using the following command:
curl -X POST -H 'Authorization: Token 7a375b52bdc410eebbc878ed3e58b2e94a8cb607' -H "Content-Type: application/json" -d '{"name":"[NAME OF ITEM]"}' https://lambda-treasure-hunt.herokuapp.com/api/adv/transmogrify/
Patience: All will become clear soon enough. Here are some resources to peruse in the meantime.
- Sample LambdaMUD spec/server
- Legacy Lambda Treasure Hunt spec
- Intro to Django github repo
- CS12: Intro to Django: Setup, Models, and Migrations
- CS12: Intro to Django: GraphQL and Graphene
- CS12: Intro to Django: REST and Users
- CS12: Intro to Django: Token Auth, GraphQL Mutations
- Official Django documentation