#version-manager #version #byond #manager #dreammaker

bin+lib melatonin

A version manager for the BYOND environment

3 unstable releases

0.7.8 Mar 11, 2024
0.7.7 Mar 5, 2024
0.5.0 Feb 3, 2024

#3 in #byond

Download history 3/week @ 2024-02-14 10/week @ 2024-02-21 62/week @ 2024-02-28 203/week @ 2024-03-06 55/week @ 2024-03-13 18/week @ 2024-03-27 37/week @ 2024-04-03

97 downloads per month


827 lines

💊 Melatonin - BYOND version manager

A version manager for the Build Your Own Net Dream (BYOND) software.

Contributions and improvements are very welcome, as this is my first Rust-based project.


build from source via

cargo install melatonin

or, with cargo binstall

cargo binstall melatonin


To quickly get started from scratch:

  1. bvm setup to setup the shims and PATH
  2. bvm install latest
  3. cd your/byondproject/path/here
  4. bvm pin latest

And done!
Now simply invoke your tools as usual, such as

  • dm project.dme - run the CLI compiler against your environment
  • dd project.dmb - run the CLI server against your built binary (BYOND 515+)
  • dreammaker project.dme - run the GUI editor/compiler

For the currently installed versions, run bvm list

For all commands and help, simply run bvm --help

Container Image

Container images are released along with semver tags
Images are tagged as (example semver v1.2.3)

  • v1.2.3 - full version
  • v1.2 - major and minor
  • v1 - major
  • latest

Example Dockerfile for a BYOND project previously pinned with melatonin:

FROM ghcr.io/atakiya/melatonin


# Assuming you're building from your project's root
COPY . .

# Setup shims and install the in the project pinned version of BYOND
RUN bvm setup \
	bvm install $(cat .byondversion)\

# Compile the project
RUN DreamMaker -verbose *.dme

# And run a dedicated server!
ENTRYPOINT [ "DreamDaemon" ]
CMD [ "*.dmb", "5513", "-invisible", "-trusted" ]


GNU General Public License v3 or later See LICENSE.md for more information.

Copyright ©️ 2024 Avunia Takiya - All Rights Reserved
Build Your Own Net Dream is Copyright ©️ BYOND Software


~467K SLoC