Releases

Changelog

What changed in each release of the game, the admin app and the server.

  1. Odyssey Server
    v13.0.0-beta.3Test release

    The third beta of Odyssey 13: no more freezes on converted worlds, help for every command, and a log of what gods do.

    Playing

    • No more freezes every few minutes on a converted world. Saving the world every five minutes stopped everything for several seconds on a world with many items lying on its floors; the same save now takes a fraction of a second.
    • Help explains every command. /help and /god list the commands you may use. /help tell, /help guild invite and /god help warp show how one is typed and what each part is. A part left out or mistyped is named, with what it should be: "map is needed: the map to warp to, by its number."
    • A warp to a map nobody has built takes you to an empty map, as Odyssey 12 did, rather than leaving your character stuck.
    • A player the server disconnects is told why. The reason for a kick or a ban could be lost as the connection closed; it now always arrives first.
    • The server answers each player's actions more quickly. Every message from the game used to make the server rework its list of every kind of message there is.

    Running a server

    • What gods do is logged. The world keeps a log of each god's maps, items, monsters, NPCs, guild halls, animations and scripts saved or deleted, and their warps, map resets, guilds disbanded, bans, kicks, renames, sprites and messages of the day. /admin checklog <player> shows the latest ten, and Odyssey Server Admin's new God activity page shows them all. Reading and clearing the log takes the View god log right, which the Server Owner role has.
    • `/god setname` keeps names unique. It refuses a name another character has, one being kept for a player who gave it up, or a reserved one.
    • `/admin access` is gone. Being a god is roles and rights, given in Odyssey Server Admin.
    • Bans hold. A ban is recorded against the player's account, which is what signing in checks, so it keeps out every one of their characters.
    • One bad row no longer stops the world saving. A change the database refuses is set aside and reported, and everything else is still saved.
    • A script named `USEOBJ` runs for every item used, before that item's own `USEOBJ` script, and returning false stops the use there.
    • An `ATTACKMONSTER` script that returns false stops the whole swing.
    • Scripts can draw in the world: text, a picture or a bar on a player, a monster or a square, for one player or everyone on the map, floating up or staying, with ShowMark. A bar can follow its target's health, mana or energy by itself.
    • Usage reports say how quickly a server keeps up, if you agreed to send them: how long things took and waited, as a tick, a player's action or a call from the admin app, never by a script's or map's name.
  2. Odyssey Server
    v13.0.0-beta.2Test release

    The second beta of Odyssey 13: the server's Docker image, on more machines.

    Running a server

    • The Docker image runs on 64-bit ARM processors too, such as an Apple Silicon Mac. Docker picks the right image by itself.
    • Odyssey Server Admin can manage a server in Docker on a Mac. The server's data folder is shared there from the Mac's own disk, which cannot hold the file the admin app's connection needs, so the server started without the admin app and said only "Permission denied". The image now keeps that file elsewhere.
    • A server that cannot make that file says which one it tried and what to do instead, rather than only "Permission denied".
  3. Odyssey Server
    v13.0.0-beta.1Test release

    The first public beta of Odyssey 13.

    Odyssey 13 is Odyssey rebuilt. The game, the server and the editors have been rewritten from Visual Basic 6 into C#, so they run on today's computers: Linux, Windows and macOS. It plays as Odyssey 12 does, with the same rules, the same art and the same keys, and a server converted from Odyssey 12 keeps its world, its characters and its scripts.

    What follows is everything that is deliberately different from Odyssey 12: old bugs fixed, things that work differently, and what is new. This is a beta, so expect rough edges, and tell us about them on the forum.

    Running a server

    • Linux, Windows and macOS, as one program. The server is one executable with a couple of small libraries beside it, and nothing to install but OpenSSL on Linux, which every modern distribution has. It can run as a service. On a Mac it needs macOS 14 or later on Apple Silicon.
    • A world is one database. Odyssey 12 split a world across its .dat and Server.ini, Classes.ini and Night.ini. Now classes, start locations, the starting kit, timers, darkness, costs and the message of the day all live in the world's database, and server.yaml holds only what belongs to the machine.
    • SQLite, PostgreSQL, MySQL or MariaDB. A world is a SQLite file by default, or a PostgreSQL (13 or later), MySQL (8.0 or later) or MariaDB (10.6 or later) database you already run, chosen in server.yaml. odyssey-server import-world puts a converted world or a backup into it.
    • Updates from the admin app. The server says when a new version is out and what changed, and you update with one click or one command. Players get a shutdown countdown, the world is backed up first, and an update that fails to start is rolled back. Before installing, the new version checks your scripts and lists any that would stop working. Nothing updates unless you choose to.
    • Shutdown counts down, with warnings, and can be cancelled. A player who signs in during the countdown is told how long is left.
    • The server can open its own ports. With Enable UPnP on, it asks your router to forward its ports while it runs. Off by default. Only works with routers that support the feature.
    • A listed server is told whether players can reach it. The website tries your server from outside, and the admin app says whether it answered and what to do if it did not.
    • Private servers. A whitelist of accounts and addresses, and invitation links you send people.
    • Crash reports, only if you agree. The admin app asks once whether the server sends Burningstorm Studios crash reports and usage statistics about itself: its version, uptime, errors, which features are on, how many players are online and which admin pages are used. Nothing is sent unless you say yes, and a report never includes anything about a player.

    Converting an Odyssey 12 world

    • Upload your `.dat` on the Odyssey website with its Server.ini, Classes.ini and Night.ini, and download the converted world. Classes come from Classes.ini, or Odyssey 12's defaults where it is missing.
    • Accounts come across without their passwords. A converted account signs in once with its old password typed in capitals and chooses a new one. One whose password cannot be read gets a temporary password from staff. Nobody, you included, can read a password afterwards.
    • Returning players can reach their old characters with their Odyssey account, if you turn on joining accounts: from character select they prove the old account is theirs, and every character of both is on one account. As Server Owner you can also join two accounts by hand, for a player who has forgotten an old password.
    • Guild rosters, declarations and halls come across, members matched to characters by name.
    • Monster descriptions come across and are shown. Odyssey 12 never showed them.
    • An item worn in the Energy Source slot comes across unworn, in its inventory slot; nothing in Odyssey 12 used that slot.
    • A world with its own art has its maps and records moved onto that art from the admin app, which also converts the old picture files.
    • Player flags survive a restart after a reset. Odyssey 12 lost every flag set since a reset whenever the server restarted. A world setting brings that back for scripts written around it.

    The admin app

    • A desktop app, for Linux, Windows and macOS, in place of the forms on Odyssey 12's server. It can install a new server from scratch.
    • Remote administration needs a sign-in, with an Odyssey account or one of the server's own, over an encrypted connection. On the server's own machine it needs none. A new server is claimed with a one-time setup code from its log: with your Odyssey account, with a new account made on the server there and then, or with one already on it, such as a converted world's god whose password nobody remembers, given a new password. The owner of its website listing can also claim it by signing in.
    • Roles and rights in place of access levels. A world starts with eight roles, which you can rename, change, delete or add to; only Server Owner is fixed. Each person can do only what their roles allow, so an editor can edit the world without being able to ban anyone.
    • World editors. Maps, items, NPCs, monsters and halls can be edited in the admin app as well as in the game, with pictures in place of numbers. A map save over someone else's newer edit is refused.
    • Players are edited one screen at a time, with one Save, not a button per field.
    • Bans keep their history. Odyssey 12 deleted a ban when it was lifted; now the record stays, and a ban can carry private notes. A server can also follow Odyssey's ban list, so a player banned on the website is turned away there and told why.
    • Passwords can be reset by staff, with a temporary password the player replaces.
    • Names. A renamed or deleted character's name is kept for its player for 30 days, so nobody else can take it; you set the number of days, or 0. You can also reserve names no character may have, such as staff's or an NPC's.
    • Backups. Odyssey 12 backed up on a timer. Now Back up now copies the world while it runs, the server backs up before every restore and reset, and any backup can be put back at the next start.
    • Database resets wait for the next start, after a backup, and can be cancelled until then. You type the world's name to confirm, and the history lists each reset with the backup that undoes it. A reset also clears what depended on what it deleted.
    • The admin app can be shown in other languages. English is the only one so far.

    Art and sound

    • The official art is never replaced. A server's own tiles, sprites, item pictures, effects, music and sounds are added beside it, declared in a manifest.json in its assets folder, and uploaded and edited in the admin app, which checks each file as a player's game would.
    • Players fetch your art from the server, or from another web address you copy the assets folder to. Each file is checked, and anything the copy does not have right is fetched from the server instead. Players download each file once, however many servers use it.
    • Art has a name, not a number. Every piece of art has a key that never changes, which maps and records keep, so a map can use tiles from any sheet. Missing art draws a marker.
    • Animations on any tile layer. Mappers make them in the game or the admin app, any number of frames with a time each, and players see a saved one at once. Every animation runs on the server's clock, so all players see the same frame. The second background layer is a layer of its own.

    Scripting

    • Scripts are C#. The converter rewrites each MBSC script as C# and keeps the MBSC beside it. The server compiles scripts itself, and the script editor, in the game and the admin app, checks as you type.
    • Scripts run in a sandbox. The same functions as before, plus C#'s own collections, maths, text and dates, and nothing that reaches files, the network or other programs. A script that tries is refused, with the line, and quarantined.
    • A runaway script is stopped, and the server carries on. A script that loops too long or calls itself too deeply is stopped and quarantined. In Odyssey 12 it hung the server.
    • A script names its parameters, and a script whose parameters do not match is quarantined with the reason.
    • `SERVERSTART` and `SERVERSTOP`. The server runs SERVERSTART once at start, before anyone can join, and SERVERSTOP as it shuts down.
    • `PlayerConnect` runs when a character is chosen, before they enter, and can turn them away.
    • Rights, roles and tags. HasRight, HasRole and IsGod ask what a player may do; GiveRole and TakeRole hand out roles; GiveTag, TakeTag and HasTag put a named tag on a character. FindPlayersWithTag, FindPlayersWithFlag and GetOnlinePlayers find players. GetPlayerAccess and flags work as before.
    • `RunScript<int>`, `RunScript<bool>` and `RunScript<string>` ask another script for a value. RunScript0 to 4 work as before, but a nested call no longer changes the calling script's arguments.
    • Scripts name art by key, such as "server:grass". The calls that take numbers still work.
    • `ResetPlayerFlag(player, flag)` resets one player's flag.
    • Several script labels per player, by id, cleared when the player leaves; a one-letter label shows.
    • INI values live in the world's database, under the same file, section and key names, so they move with the world. A server's old script .ini files are not converted yet.
    • `PrintToIRC` and `PrintToChannel` write to the server log. Odyssey 12's IRC relay was switched off, so they did nothing.
    • Fixes to Odyssey 12's script functions: - TakeInv takes from the slot it is given; in Odyssey 12 it never took anything. - GiveInv's arguments land where its declaration says. - DisplayObjDur covers all 30 slots, not just the first 20. - SetInvObjectVal and SetPlayerLevel update the player's screen. - SetPlayerMaxHP, MaxEnergy and MaxMana change the maximum with the player's gear at once, not only the maximum before it. - AttackPlayer makes a real kill: the killer becomes the murderer, not the victim. - SetPlayerName refuses a name another character has, or one held or reserved. - MapRefresh shows the map as it is running, without saving it. - GetMonsterDesc returns the monster's description. - GetEquippedObjNum answers for the slot asked about, not always the primary hand. - UNUSEOBJ<n> names the item being taken off. - LEAVEGUILDHALL is told which hall the guild left. - GETOBJ and DROPOBJ are handed the same values wherever they run. - GetAttData and GetAtt2Data with index 4 read 0. - Time.Get, Hall.Get, Tile.Upload and ClassData.Name do what their fields say. - Mid, Mid2, Replace2 and Sqr given a value out of range give empty text or 0, instead of an error. - Effects play their end sound, land on their target, use their own frame count and animate from the moment a player arrives; an out-of-range number sends nothing. - A warp within the same map only moves the player, without running the map's leave and join scripts. - A script's change to a map's weather, darkness or flags shows at once.
    • Small changes a script might notice: - GetMonsterTarget answers -1 for no target, SpawnMonster answers -1 when it cannot make the monster, and MonsterWarp accepts map 1. - & and | between two conditions stop at the side that settles the answer. Every converted script we tested behaves the same. Prefer && and || for new scripts. - A call with arguments left off gets 0 for them, and a script that asks for more than the server gives it gets 0 there.
    • The memory functions (HeapAlloc, CopyMemory and the rest) do nothing, and a later release removes them.

    Settings

    Odyssey 12's fixed numbers are settings, with Odyssey 12's values as their defaults:

    • The time between swings, the energy a swing costs, the level cap, the flood limit and the training stat cap.
    • Guild limits: how many guilds, the level to join, the cost of an invitation, and the members needed to keep a guild or buy a hall.
    • Guild dues: the daily charges, and a switch to turn them off.
    • The mana a tell and a broadcast cost.
    • Whether a worn item keeps its inventory slot.
    • The durability multiplier for weapons and armour bought from a shop. Odyssey 12 tripled it; the default is now 1, and 3 is Odyssey 12's.
    • Repair, off by default. Odyssey 12 had it switched off in its build, so no server could use it.
    • The world's starting kit can be longer than eight items.

    Gameplay changes your players will see

    • Gameplay formulas are scripts you can edit: damage, armour, hit rolls, experience, kill value, levelling and regeneration. They reproduce Odyssey 12 exactly to start with.
    • Monsters land their hits more often. Odyssey 12 rolled a monster's swing twice against the player's agility and needed both, so one passing alone showed a hit for 0 or a miss after armour had worn. A monster now rolls once, as a player always did. To keep Odyssey 12's rate, edit the MonsterHitsPlayer script.
    • Bows fire real shots that fly the way the player faces, a square at a time, and hit the first monster, player or wall they meet. An item's Speed is how long its shot takes to cross a square. A shot can have its own effect for each direction; a converted item that used 255 for this has the four directions filled in.
    • A map lists as many monsters as you like, and Double Monsters is gone: a converted map that had it lists each monster twice, so it spawns as it did.
    • Breaking walls is fixed, and a wall can rebuild itself when its map resets.
    • New characters start with full HP, and a server started at night is night.
    • Item fixes: rings from shops last, relics' Newbified box works, a bow's own damage counts, armour no longer heals itself, and trades check everything first.
    • Guilds can be run from chat, and a deed is spent only when the guild is founded.
    • `/ignore`, chat scrollback, key presets, `/quit` for everyone, and gods can set their powers aside with /god off.

    Not carried over

    • The server's admin password, tileset number, "encrypt dat file", checksum validation, minimize-to-tray, and Odyssey 12's registry and its admin commands.
    • The Account Delay option, which Odyssey 12's server never used.
    • Account logs.
  4. Odyssey Server
    v0.1.1Test release

    A test release with fixes from the first round of testing.

    • Put your world's database (and its assets folder) beside odyssey-server before the first start, and the server moves them into its data folder and uses them. If it finds no world, it says where it is creating an empty one. The download now includes a README explaining the layout.
    • A databaseFile given without a folder in server.yaml is looked for in the data folder, however the server was started.
    • The log is quieter: failed database queries no longer print pages of detail.
    • Accepting a whitelist invitation for an account that is already on the whitelist no longer adds it twice.
    • The server is now called Odyssey Server.
  5. Odyssey Server
    v0.1.0Test release

    The first test release of the new Odyssey server.

    • Runs a converted Odyssey world, managed from the Odyssey Server Admin app or a terminal.
    • List your server on the Odyssey website so players can find it and join with one click.
    • Updates itself when you choose to: the admin app, or odyssey-server update, downloads the new version, checks your world's scripts against it, gives players the usual shutdown countdown, backs up the database and switches over. If the new version does not start, the previous one comes back, database and all.