Index of /~ramiro/public_git/spelloff

	Name	Last modified

	Parent Directory
	addons/	2025-06-08 00:03
	audio/	2025-08-11 00:28
	doc/	2025-08-13 09:35
	fonts/	2025-08-01 10:46
	releases/	2025-08-14 13:36
	src/	2025-08-14 10:34
	textures/	2025-08-08 22:19
	BUGS	2025-08-14 10:34
	CONTRIBUTORS	2025-08-11 18:07
	COPYING	2025-08-13 09:35
	NEWS	2025-08-14 10:34
	README	2025-08-14 00:55
	TODO	2025-08-14 10:34
	export_presets.cfg	2025-08-11 18:07
	icon.svg	2025-08-01 19:49
	icon.svg.import	2025-08-01 19:49
	project.godot	2025-08-14 10:34

git@covacha.net.ar:/home/ramiro/public_git/spelloff

Spelloff

The orb ponderer's arena first-person shooter.

Spelloff is a (kinda bare-bones) multiplayer first-person shooter in the tradition of arena-shooters such as Quake.[^1] Although primarily intended to be a fast-paced 1 vs. 1 dueling game, it features configurable team or free deathmatching modes.

Gameplay

Spells

Players choose loadouts consisting of three spells. They serve as weapons and can be switched between with keys 1 through 3. You can whack people with your grimoire, bound to 4, and recover mana spent from casting spells by pressing r. All of these are default bindings that you can customize.[^2]

Fire, earth, lightning and ice tomes allow you to cast ranged spells for some amount of mana. Other spells may be passive buffs or melee weapons. The in-game blurb should describe how each function well enough.

Multiplayer

Spelloff implements peer-to-peer networking (that is, no central servers to connect to) and can be played locally or online.

Joining a game

To join a game, ask the host for their connect address, which they'll find on the Game tab once they begin hosting.

Hosting a game

Spelloff, being peer-to-peer, makes your client double as a server when you host a game.

It needs to be allowed UDP traffic on port you chose to host on on your computer's firewall. On Windows and MacOS, hosting should trigger a prompt to allow that. Linux distributions don't usually do this, a firewall rule has to be manually added.

For players outside your local network to join, the port must be forwarded on your router, allowing them to join using your public IP address. Spelloff will do this for you if your router supports UPNP.[^3] If all goes well, you'll find your address on the Game tab after a short delay.

Troubleshooting

Make sure Spelloff's UDP traffic is allowed through your computer's firewall on the port you chose to host on. If you were not prompted for permission, try manually adding a rule on your firewall.
If the game fails to forward a port:
- Make sure UPNP is enabled on your computer. This is sometimes referred to as "network discovery".
- It's also possible your router doesn't support UPNP, in which case you'll have to manually configure port forwarding on your router.

LAN-only mode

If you want to host LAN-only games, you can do so by enabling the LAN-only preference. Spelloff will skip trying to map a port on your router and will fill out your connect info with your local address instead of your public one.

Spelloff error codes

List of error codes
List of UPNP-specific error codes

FAQ

Why does this look like garbage?

Sorry, got no 3D modeling skills just yet. Hope the actual FPS mechanics came out smooth enough to make up for it. Hopefully I'll give it a proper art-pass at some point.

Why do I gotta do this complicated port-forwarding stuff to host?

Spelloff tries to save you this hassle using UPNP, but your router may not support it. Being a little toy project, it doesn't really merit me ponying up for dedicated servers or a Steam license to access Steam's P2P networking API, which would solve this problem.

Is the source for the shoutbox server available?

Yes.

http://covacha.net.ar/~ramiro/public_git/spelloff-shoutbox-server/

Game lags while host's game window is unfocused, help?

Seems to be an issue with Godot running under Wayland. Try launching the game with the flag --display-driver wayland.

https://github.com/godotengine/godot/issues/87818

Copying

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

See COPYING file for more information and game assets licensing.

Elsewhere

Spelloff is available on itch.io.

https://rbasile.itch.io/spelloff

Contact

If you need help, would like to report a bug, contribute, or have any other questions, shoot Ramiro an email.

rbasile@posteo.net

[^1]: It's honestly just a home-brewed version of TF2's MGE mod.

[^2]: Actually, you can't, this hasn't been implemented yet lol.

[^3]: When you quit the game, a request is made to your router to remove the port mapped for Spelloff.