Yet another project about creating a 3D virtual world and stuff.
Powered with Nest (or Quart), Angular and Three.js.
First we need to fetch all dependencies:
$ npm ci
Then we build the frontend:
# You can also use build:prod to build a production-ready bundle
$ npm run build -w frontend
Note
There are two different implementations for the backend server: Node or Python.
Nothing more is needed after npm ci
postinstall.
$ python -m venv venv
$ source venv/bin/activate
$ pip install -r backend-py/requirements.txt
$ prisma generate --schema backend/prisma/schema.prisma --generator client-py
$ npx -w backend prisma db push --skip-generate
Warning
There is no node script to import worlds yet, so you have to use the python one instead.
# See above for the venv setup
$ prisma db push --schema backend/prisma/schema.prisma
$ cd backend-py
$ python tools/import_lemuria.py
This will create and init the database backend/app.db
using the data in dumps/atlemuria.txt
and dumps/proplemuria.txt
.
Caution
If the database already exists, the world data will be overwritten.
Once again, you can choose between node or python to serve the world resource files. To avoid CORS issues when accessing static files from a web browser, do the following:
$ npx -y http-server -p 8181 -c-1 --cors
$ cd backend-py
$ python tools/serve_path.py
This will run a script to serve files in the current directory on port 8181
.
You will also need the village2
resource path to be served, to do so you can create a symlink by running the following (but set the path correctly first):
$ ln -s /my/path/to/resource/directory/for/village2 village2
By default, the API backend is listening on port 8080
.
$ npm -w backend run start
$ prisma generate --schema backend/prisma/schema.prisma --generator client-py # only needed if the prisma version or the schema changed
$ cd backend-py
$ python app.py
You can also generate a docker image to build the project and run the server in a container:
# Build with the node backend
$ docker build --target node -t lemuria .
# OR with the python backend
$ docker build --target python -t lemuria .
$ docker run -it -p 8080:8080 -v $PWD/backend/app.db:/app.db lemuria
You can use node or python bots on Lemuria. See the bot
and bot-py
directories.
// typescript
import {Bot} from './bot'
# python
from bot import Bot
Tip
An example bot bonobot.ts
/bonobot.py
is available in this repository.
Once npm run start
(or app.py
) and http-server
(or serve_path.py
) are running: open your favorite web browser and go to http://localhost:8080
,
you should be prompted with a login screen. Put whatever nickname you want, the password you provide doesn't matter as
there's no proper authentication for the moment.
The main aim of this project is to access worlds of Active Worlds in a web browser, using dump files and paths to resource objects. Compatibility is essentially based on browser version 3.6.
This project does not use any code from AW or its SDK.
This project is NOT associated with Active Worlds or ActiveWorlds, Inc.
Caution
We cannot be held responsible for any loss of data that may occur while using Lemuria. This includes world data, user data and any other information managed by the application. We strongly recommend that you make regular backups of your files and database.