______ __ __ _____ __ ______ ______ ______
/\ ___\ /\ "-.\ \ /\ __-. /\ \ /\ ___\ /\ ___\ /\ ___\
\ \ __\ \ \ \-. \ \ \ \/\ \ \ \ \____ \ \ __\ \ \___ \ \ \___ \
\ \_____\ \ \_\\"\_\ \ \____- \ \_____\ \ \_____\ \/\_____\ \/\_____\
\/_____/ \/_/ \/_/ \/____/ \/_____/ \/_____/ \/_____/ \/_____/
______ __ __ ______ ______ ______
/\ __ \ /\ \/\ \ /\ ___\ /\ ___\ /\__ _\ |v0.1.0
\ \ \/\_\ \ \ \_\ \ \ \ __\ \ \___ \ \/_/\ \/ |
\ \___\_\ \ \_____\ \ \_____\ \/\_____\ \ \_\ _ _|_ _
\/___/_/ \/_____/ \/_____/ \/_____/ \/_/ |;|_|;|_|;|
\\. . /
An infinite multiverse of \\: . /
\,/ persistent and generative ||: |
fantastical dream worlds, \,/ ||:. |
/`\ each populated by endless ||: .|
& thematically consistent ||: |
fantasy destinations, and /`\ ||: , |
an intruiguing population ||: |
of strange and marvellous ||: . |
_____ beings, all AI generated! _||_ |
____--` '-~~_ __---` ~`--,__
~-~-~ `~~----__-~,.-`~~--~^~~--.__,--~' fDm `~~
What has happened to me? The last thing that I remember, I went to sleep just like any other night.
Now I'm here in this strange place, wherever this is. This feels like a dream, but I can't wake up.
There are others here too. Deadly beasts, sentient artefacts, devious tricksters, lost souls, and... the Lord of this Realm. They all seem bound to this place, but I'm not. I've got to get out of here!
A love letter to the Autonomous Worlds Hackaton, May 18th to 26th 2023.
Endless Quest is an an autonomous world engine for generating infinite, dynamic roleplaying challenges; no two the same. Quest encounters are powered by a sophisticated, behavioural AI storytelling system that ensures narrative and stylistic consistency.
Endless Crawler is used to generate each realm map, with encounters generated and persisted as they are first explored by players. Realms allowing endless re-interpretation of the Endless Crawler chambers across an infinite number of thematically consistent worlds.
Endless Quest is an endless, generative roleplaying game, in which you play a traveller lost in the infinite realms of the dreaming. As you travel through each realm, you will discover infinite unique locations and the lost souls bound to them; no two alike. Each location and character that you meet in Endless Quest is unique, and indeed, each of its many realms is generated - in its entirety - dynamically by an AI storyteller.
Each realm generates endless unique locations and characters that are thematically consistent, from one of four sub-themes and eight different kinds of encounters that are unique to that realm. Locations and characters are generated once only, the first time that they are discovered, after which they are persisted permanently on-chain.
Once a location has been generated it will remain, however each traveller's visit will be a dynamic, story driven experience that responds to the player, powered by the AI storyteller.
- Mataleone @rsodre
- Recipromancer @Rob-Morris
- Mentis @Mentis123
- The amazing art of PixiVan
more screenshots
- Lattice MUD
- Endless Crawler chambers from mainnet contracts
- OpenAI API
- wagmi
The core of the generative experience is run by two GPT prompts, both detailed in /AI/Prompts/:
- Metadata-Generation.md -- Generates the metadata for each world, chamber and encounter
- NPC-dialog.md -- Runs the interaction with each NPC
Art Assets are generated using DALL-E via OpenAI API, as detailed in GenerativeArt.md
A Phaser MUD client
Install Node.js 16+ (we use version 18)
- Install pnpm
$ npm install --global pnpm$ brew install libusb
$ curl -L https://foundry.paradigm.xyz | bash
# restart the terminal or open a new one
$ foundryup- Do this setup...
Edit MUD3/env.contracts if you want to use your own Anvil private key.
$ cd MUD3
$ pnpm install
$ cp env.contracts packages/contracts/.envTo start a local server on http://localhost:3300 :
$ pnpm run devTo use a local sync server, edit MUD3/packages/client/.env to contain this, and restart:
VITE_SERVER_URL=ws://localhost:8787
Your OpenAI API key needs to be stored on cookies.
A GPT-4 key is preferred, but it also works with GPT-3.
The first time the app is loaded on a browser, empty cookies will be created for editing.
| cookie name | value |
|---|---|
OPENAI_API_KEY |
sk-xxxxxxxxxxxxxxxx |
OPENAI_ORG_ID |
org-xxxxxxxxxxxxxxx |
GPT_MODEL |
gpt-4 or gpt-3.5-turbo |
The wallet used for deployment must have ETH on the network.
# Lattice testnet
$ pnpm mud faucet --address <address>
# Other networks
$ pnpm mud faucet --faucetUrl <faucetService> --address <address>Paste the deployment wallet private key to PRIVATE_KEY in MUD3/packages/contracts/.env
Edit profiles at MUD3/packages/contracts/foundry.toml
# deploy locally (http://localhost:8545)
$ cd MUD3/packages/contracts
$ pnpm mud deploy
# deploy to the lattice testnet
$ cd MUD3/packages/contracts
$ pnpm mud deploy --profile lattice-testnet
# deploy to optimism mainnet
$ cd MUD3/packages/contracts
$ pnpm mud deploy --profile optimism-mainnetIf in error and need to retry...
$ pnpm mud deploy --profile lattice-testnet --priorityFeeMultiplier 5Deploy contracts to testnet...
$ cd MUD3/packages/contracts
$ pnpm deploy:testnet
> chainid 4242Build distribution...
$ cd MUD3/packages/client
$ pnpm build
$ ls -l dist/If you get some out of memory error like below, increase node memory and try again...
FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory
$ export NODE_OPTIONS=--max-old-space-size=8192
$ pnpm build- MUD getting-started
Need Node 18 and Foundry (see above)
$ npm install -g pnpm
$ pnpm create mud@canary MUD
? Template
> phaserCheck latest version here
$ cd MUD3
$ pnpm mud:upSpecifig tag...
$ cd MUD3
$ pnpm mud set-version --tag next && pnpm install
# or...
$ cd MUD3
$ pnpx @latticexyz/cli@next set-version --tag nextSpecific version...
$ cd MUD3
$ pnpm mud set-version -v 2.0.0-alpha.1.197
$ cd packages/client
$ pnpm mud set-version -v 2.0.0-alpha.1.197
$ cd -
$ cd packages/contracts
$ pnpm mud set-version -v 2.0.0-alpha.1.197
$ cd -
$ pnpm install