Piqueserver 1.2.1

Fixes

• #785 Fix commands that don't return anything throwing an error after being called
• #788 Fix /revertrotation command not working
• #791 Calculate the right number of params for wrapped/guarded commands
• #792 Fix votemap breaking with non-lowercase map names

Improvements

• #789 Modernize the command callback introspection
• #790 Modernize the package

Full Changelog: v1.2.0...v1.2.1

Piqueserver 1.2.0

Features

• #774 Make the server send its supported extensions to the client
• #775 Send extensions in HELLOLAN
• #777 Add on_client_info() event

Improvements

• #776 Lower the compression level to 5
• #780 Add map_extensions.py authors

Fixes

• #770 Add missing space between message and username
• #771 Rework broken friendly_fire_on_grief() logic
• #778 Drop grenades with invalid velocity and keep calculations in sync
• #783 Replace improper uses of the Twisted logger

Full Changelog: v1.1.1-post2...v1.2.0

Piqueserver 1.1.1

This release fixes packaging issues. It contains no changes from 1.1.0

Piqueserver 1.1.0

Release Notes

Deprecations

• Now piqueserver warns for deprecated functions, protocol.send_chat() -> protocol.broadcast_chat() and protocol.send_contained() -> protocol.broadcast_contained(). You still can use these functions, but in future the legacy functions will be removed. (f8061ec)
• Removed support for EOL python versions (72d449a

Improved World Update

World update now warns when server delays to start a world update, and warns if it took too long for finishing world update. Instead of looping through 32 players, just loop from 0 to the highest player id online, helping to save processing. (#575)

Anticheating

• Check for impossible shots through the fog (#707)
• Cap grenade velocity (#708)
• Cap grenade fuse to 3s (#746)

Savemap.py

• Added /savemap and /rmsaved commands, and save_at_shutdown config option. (#590)
• Added always_save_map option for saving map when advance rotate or server shutdown. (#594)
• Hide .saved suffix from masterlist map name. (#631)

Gamemodes Update

• Added tdm.py option score_percentage to show score as a percentage. (#748)
• Added ffa.py option isolate_player to isolate player in blue team vs all. (#750)
• Fix onectf.py not checking for map extensions. (#609)
• Fix arena.py gamemode crashing when other scripts uses on_world_update() (#730)

Scripts Update

• New alias for /advancemap, use /advance. (5ef5adb)
• Show remaining kills left for getting an airstrike. (#710)
• Show players IDs on votekick, to avoid confusion (#717)
• Fix error on analyze.py when not giving a target player. (#606)
• Fix badmin.py failing when checking for rifle percentage. (#613)
• Fix daycycle.py overriding local variables. (d78b63c)
• Fix rollback.py setting dirt blocks to black. (#727)
• Fix votekick.py not allowing to votekick players with # on their names. (#737)

Misc

• /set_location centralizes players on block (#576)
• Added /load_map command for instant map advance. (#594)
• Moved RateLimiter class to util file (8fbf42f)
• Use RateLimiter for chat antispam (ef9fb66)
• Speed up client detection (#723)
• Truncate too long messages causing server lag (#733)
• Truncate too long os_info on version info packet, causing server crash (#741)
• Doesn't allow players to flood send_lines(), causing server lag. (#722)
• Allow to use /switch on spectators, or specify switch team. (#738)
• Added support to custom chat messages for any client that supports extensions. (#747)
• Added limit to block line place. (#758)
• Added command antispam, to prevent server lag. (#721)
• Support Python 3.9 (9d7e73d)
• Fix bug when disabling web server logging, webserver not being able to start (2d08092)
• Fix error when not passing a tips array on config (#580)
• Fix bans disappearing when temporary bans reachs an end. (#729)
• Fix empty player names throwing errors on console, and player being stuck on limbo. (b10c381)
• Fix grenade being sent on blockaction packet for griefing. (#734)
• Fix admins not able to use /move on players. (#736)
• Fix error when trying to use Python 3.11 (#742)

Piqueserver 1.0.0

Release Notes

Piqueserver has hit 1.0.0! This release has been around a year in the making and is accordingly jam-packed with new features:

TOML config

JSON is hard to write and doesn't support comments. Many beginners had lots of issues with the strict syntax of the JSON format and we could not show useful comments describing the options directly in the config file. We've switched the default config to TOML, which is an .ini inspired format that is easier for humans to read and work with.

JSON is of course still supported, but only recommended if you are using another program to generate piqueserver configs.

New config engine

We've added a new config engine that allows you to declare options and sections in code, then automatically fetch and validate the values. Declaring options in advance also allows us to tell you about options which are unused, helping you catch typos.

Logging with log levels

Piqueserver's logging was always a pain when debugging the server or scripts. Piqueserver now emits low-level debug messages for things such as grenade throws, player spawns, etc.

Since these messages are not of interest to most users, they are turned off by default. You can enable them with:

[logging]
loglevel = "debug"

Time Values in Config

Piqueserver now supports setting time values with time units, instead of opaque values:

tips_frequency = "5min12sec"

Lots of Windows fixes

While Windows was theoretically supported before, support should have improved a lot now. Please report any bugs in our issue tracker!

Removal of python2 support

As announced previously, this is the first version will not support python2.x. We are also removing support for python3.4 in this release. This is also the last release to support python 3.5.

Improved docs

Our docs at https://piqueserver.readthedocs.io have improved a lot. Instead of only being useful for devs, they now contain documentation for all config options, scripts and of course setting up Piqueserver. Have a read!

Multi-threaded map generation

People on lower-powered hardware have complained about map generation taking too long and timing out players. We've moved those to a new thread for a smother experience switching maps.

HELLOLAN

HELLOLAN is an AoS 1.x feature that allows you to auto-discover servers on your LAN. It is currently only supported by BetterSpades

GeoIP2

Piqueserver now supports the new GeoIP2 format, the downloads for the old format were shut off. It is also now downloaded and checked securely. Thanks @bieito98!

Data saving on world updates

While not intended, it is possible to save bandwidth when sending out world updates by only sending updates for players that are actually connected. We now do this. We have tested this, but it might occasionally cause issues with Voxlap. If you have issues with players moving to weird positions after this update, let us know!

Release Notification

A big thing we wanted to add before a full release is release notifications to ensure all users of piqueserver are made aware when a new release is available and can upgrade soon. Update notifications will be displayed on login and on the console.

UTF-8 Support

OpenSpades' UTF-8 support allowed sending unicode in chat messages between players, but the server wasn't able to send any unicode itself. This has now been fixed. Thanks @MuffinTastic !

Infiltration

Infiltration can now be configured via the regular config, in the [infiltration] section:

    [infiltration]
    # Attackers get attacker_score_multiplier points for taking and capturing
    # the intel.
    attacker_score_multiplier = 10

    # Defenders gain 1 point for every defender_score_interval seconds that the
    # intel remains untouched.
    defender_score_interval = "30sec"

    # The ratio of attackers to defenders. Be aware that setting this
    # incorrectly might prevent players from joining
    attacker_ratio = 1.6

Updated Push

@1AmYF Updated the push game mode to the latest version, as well as enabling it to be configured in your piqueserver config.

Extension Support

Piqueserver will now query any client that isn't OpenSpades <= 0.1.3 for it's extension support. This will, allow extending the protocol with new weird and wonderful things.

Refactoring

As always, a lot of our work goes into improving and renovating the insides of piqueserver. This does not affect users, but is always prerequisite to making more changes in the future.

Misc

• --copy-config will now not fail if the directory already exists. Instead, it will attempt to create any files that don't yet exist
• farbuild exploit mitigation is improved and less susceptible to latency
• fixed several DOS exploits (crashes caused by malicious players)
• updated status server to new bootstrap version
• the status server now returns the correct MIME type for the overview
• no longer make all users admins if no passwords are given
• add development dockerfile
• decrease size of docker container
• the analyze script is now part of the default distribution
• the commands command lists available command
• more commands now have a help message
• a bug was fixed that prevented joining the spectator team on ARM
• add `--version' option to view installed version
• you can now use asyncio in piqueserver in addition to twisted
• fixed afk.py kicking users accidentally
• log the kick reason when kicking and log performance of map advances
• show voxlap in /client command
• Inspired by recently found crashes, piqueserver can now be compiled with AddressSanitizer and UndefinedBehaviourSanitizer using the USE_UBSAN and USE_ASAN environment variables.

Piqueserver 1.0.0

Release Candidate

This is the first release candidate for RC1. We have a few more things we want to get into this release, but are tagging the current state as a preview of what's to come and to allow people to test it easier.

This prerelease can be installed via pip directly from git: pip install git+https://github.com/piqueserver/piqueserver@v1.0.0rc1

Release Notes

Piqueserver has hit 1.0.0! This release has been around a year in the making and is accordingly jam-packed with new features:

TOML config

JSON is hard to write and doesn't support comments. Many beginners had lots of issues with the strict syntax of the JSON format and we could not show useful comments describing the options directly in the config file. We've switched the default config to TOML, which is an .ini inspired format that is easier for humans to read and work with.

JSON is of course still supported, but only recommended if you are using another program to generate piqueserver configs.

New config engine

We've added a new config engine that allows you to declare options and sections in code, then automatically fetch and validate the values. Declaring options in advance also allows us to tell you about options which are unused, helping you catch typos.

Logging with log levels

Piqueserver's logging was always a pain when debugging the server or scripts. Piqueserver now emits low-level debug messages for things such as grenade throws, player spawns, etc.

Since these messages are not of interest to most users, they are turned off by default. You can enable them with:

[logging]
loglevel = "debug"

Time Values in Config

Piqueserver now supports setting time values with time units, instead of opaque values:

tips_frequency = "5min12sec"

Lots of Windows fixes

While Windows was theoretically supported before, support should have improved a lot now. Please report any bugs in our issue tracker!

Removal of python2 support

As announced previously, this is the first version will not support python2.x. We are also removing support for python3.4 in this release.

Improved docs

Our docs at https://piqueserver.readthedocs.io have improved a lot. Instead of only being useful for devs, they now contain documentation for all config options, scripts and of course setting up Piqueserver. Have a read!

Multi-threaded map generation

People on lower-powered hardware have complained about map generation taking too long and timing out players. We've moved those to a new thread for a smother experience switching maps.

HELLOLAN

HELLOLAN is an AoS 1.x feature that allows you to auto-discover servers on your LAN. It is currently only supported by BetterSpades

GeoIP2

Piqueserver now supports the new GeoIP2 format, the downloads for the old format were shut off. It is also now downloaded and checked securely. Thanks @bieito98!

Data saving on world updates

While not intended, it is possible to save bandwidth when sending out world updates by only sending updates for players that are actually connected. We now do this. We have tested this, but it might occasionally cause issues with Voxlap. If you have issues with players moving to weird positions after this update, let us know!

Refactoring

As always, a lot of our work goes into improving and renovating the insides of piqueserver. This does not affect users, but is always prerequisite to making more changes in the future.

Misc

• --copy-config will now not fail if the directory already exists. Instead, it will attempt to create any files that don't yet exist
• farbuild exploit mitigation is improved and less susceptible to latency
• fixed several DOS exploits (crashes caused by malicious players)
• updated status server to new bootstrap version
• the status server now returns the correct MIME type for the overview
• no longer make all users admins if no passwords are given
• add development dockerfile
• decrease size of docker container
• the analyze script is now part of the default distribution
• the commands command lists available command
• more commands now have a help message
• a bug was fixed that prevented joining the spectator team on ARM
• add `--version' option to view installed version
• you can now use asyncio in piqueserver in addition to twisted

Piqueserver v0.1.3

Changes

This is a bug-fix release, so don't expect any grand new features.

Move Command

The /move command and /goto command have long done very similar things. Thanks to @esplemea and @Perpolo, these have now been merged into one. All possible syntax placements are:

/move A4                       # Move yourself to sector A4
/move 256 256 30               # Move yourself to specific coordinates
/move targetPlayer A4          # Move targetPlayer to sector A4
/move targetPlayer 256 256 30  # move targetPlayer to specific coordinates

This is the first of a number of changes made by Students of the KTH Stockholm as part of their studies.

--copy-config Enhancements

In the past, --copy-config would fail if you already had a directory in that location. Now it will create a backup and update the folder structure instead.

Bugfixes

A few very old bugs allowed users to do fun things like crash the server and teleport to random locations. These bugs have been fixed. We will be keeping a lookout for more of those.

Other Small Things

• Scripters can now more easily add new packets
• The status server now shows the client version

Python 2

This is the last ever release for python2, which makes us very very happy. If you need any assistance in moving your servers or scripts to py3, or for anything else really, you can always talk with us and we'll help.

Installation from PyPi

Python 2.7 or 3.4+ and pip are required.

To install the latest version using pip3:

$ pip3 install --upgrade piqueserver # Installs latest piqueserver from PyPi

Installation with Docker

Please see our wiki page about Docker.

Installation from the source code

Python 2.7 or 3.4+, pip and virtualenv are required.

To build:

$ virtualenv -p python3 venv && . ./venv/bin/activate # Activate virtualenv session
(venv) $ pip install -r requirements.txt             # Install requirements
(venv) $ python setup.py install                     # Build and install piqueserver
(venv) $ deactivate                                  # Deactivate virtualenv session

(replace -p python3 with -p python2 if you intend to run piqueserver in Python 2)

Running

Running pique is a easy as:

$ piqueserver # OR
$ piqueserver -d YOUR_CONFIGS_FOLDER_LOCATION

The default configuration directory location is ~/.config/piqueserver/.

The configuration directory for any piqueserver instance can always be specified using the -d option, thus allowing for per-instance configurations.

Piqueserver v0.1.2

Changes

This is a bug-fix release, so don't expect any grand new features.

Arena Gamemode

• Players are now restocked on round start, which enables you to spam the hell out of your weapons during the caged period without losing any ammo when the round truly starts
• Respawn time during the cage period will be set to 0, which allows you to switch weapons/teams without risking not being able to spawn when the round begins

Dead Players Are Now Dead (when joining a server)

AoS 0.75 protocol has no way of informing the client a player is dead on server join, leading to some very confusing situations on arena.

As a workaround, we tell any newly connected clients that all players that should show up as dead just committed suicide ¯\_(ツ)_/¯

Web Documentation

As part of our effort to make script writing easier, we have set up automatically generated documentation for piqueserver. You can find this documentation on readthedocs. We don't currently have a main page yet, so you will need to click on "module index" to get to the list of pages.

We'll be incrementally improving this over time.

Other Small Things

• Strip ascii control codes from player names
• Show nicer errors when adding an invalid map to the config
• Try sending client version handshake as soon as possible instead of only after map load (which is useful for client feature detection)
• Fixed bug where using /god in the console would cause an error
• Fxed bug where using /client without target would cause an error
• Fixed error when handling error creating new config directory on python2
• aimbot2.py now outputs proper CSVs
• --copy-config now works properly again

Python 2

Python 2 is reaching its end of life, so we will drop support for it right after the next release. If you haven't already, switch your piqueserver to Python 3 as soon as possible.

If you need any assistance in porting to py3, or for anything else really, you can always talk with us and we'll help.

Installation from PyPi

Python 2.7 or 3.4+ and pip are required.

To install the latest version using pip3 (or pip2 for Python2) :

$ pip3 install --upgrade piqueserver # Installs latest piqueserver from PyPi

Installation with Docker

Please see our wiki page about Docker.

Installation from the source code

Python 2.7 or 3.4+, pip and virtualenv are required.

To build:

$ virtualenv -p python3 venv &&. ./venv/bin/activate # Activate virtualenv session
(venv) $ pip install -r requirements.txt             # Install requirements
(venv) $ python setup.py install                     # Build and install piqueserver
(venv) $ deactivate                                  # Deactivate virtualenv session

(replace -p python3 with -p python2 if you intend to run piqueserver in Python 2)

Running

You can specify the location of the configuration directory using the -d option. This allows you to have multiple configurations for different instances of piqueserver.

The default location is ~/.config/piqueserver/.

To run:

$ piqueserver # OR
$ piqueserver -d YOUR_CONFIGS_FOLDER_LOCATION

Piqueserver v0.1.1

Changes

Python3 Support!

Piqueserver now has full Python3 support and has been tested on a small scale. This is a big milestone on our path of making piqueserver a modern AoS server. Once we are comfortable with dropping Python2 support, this enables us to use the large number of features added since Python2.

While the base server and included scripts have been tested, some third-party scripts might be broken by this, and we will gladly help you with porting them over. Nonetheless, we will be maintaining Python2 support for at least another one or two versions to help the transition.

Python3 support is also a big step since it means we now have...

Windows Support

With Python3 support comes Windows support. Since we now have a developer that actually uses Windows, we can certify that piqueserver does in fact work on Windows with Python3. There are still some quirks, like an unintuitive folder name, but it should work just fine. Since most of us are on Linux or OS X, we are reliant on your support to find problems with piqueserver on Windows, so please do test it and report back!

Default Scripts Have All Been Tested

All scripts included with piqueserver have been reviewed and tested to ensure they can work out of the box with both Python 2 and Python 3 without any obvious bugs. If you do find any bugs we have missed, please report them!

Some scripts are no longer supported:

• fbpatch.py: is now included inside piqueserver's code
• query.py: added support for an query protocol that we believe no uses, so it was removed
• nosharp.py: is no longer necessary since piqueserver allows players to be kicked by id even if their names begin with a # (tip: id always take precedence in player-related commands)
• platform.py: was too big to maintain (2k lines of code) and might be replaced with a simpler platform2.py version in piqueserver-extras in the future
• commandhelp.py: help for commands is already included in piqueserver, although it needs some polishing.
• stats.py: the server used here is not available anymore

All of the unsupported scripts have been moved to the piqueserver-extras repository, inside the unsupported-scripts folder.

Gamemodes now have their own folder

This requires some changes to existing configurations:

1. create a game_modes dir in your config directory
2. move the game mode scripts you use from the scripts dir into the game_modes dir

If you were using the full module specification eg. (piqueserver.scripts.push), you'll need to update to (piqueserver.game_modes.push).

Manhole Server

A long-broken and rarely-used PySnip feature has been fixed. The Manhole SSH server can now be enabled again to allow SSH access to the python console of the server. In addition, syntax highlighting has been added.

ip_getter

IP getter (a.k.a. ip_getter) is the service that piqueserver uses to discover your public IP address when the server runs behind NAT routers. Previously, it was hardcoded, but now you can set it with the ip_getter setting in your config file. Additionally, it was tamed to not spit undecipherable errors at you when something goes wrong and provide a helpful error message instead.

Commands

Comands such as /lock can now use team names as a parameter instead of only accepting blue, green or spectator. For convenience, the 1, 2, and spec aliases will also be available.

Now /godsilent will let you know if you have quit godmode instead of misleadingly always tell that "You have entered god mode". Furthermore, now when /godsilent is used to silently turn someone else in godmode, the receiving player will be informed of it.

Also:

• /version now returns the correct version
• /client doesn't requires a target player anymore
• /fog now accepts hex color codes (e.g. #efefef or #00ff00)

Other Small Things

• Some documentation was added in the code to aid developers
• Name colisions are no longer treated differently for "Deuce" players
• The server aos:// link is now displayed in statusserver (e.g. https://piqueserver.walladge.net/ has a link to aos://764867901:32887)
• pyenet now has wheels for linux, vastly improving the installation time on the platform
• The random.txt map now works in Python 3
• Console input has been fixed (although not on Windows yet)
• piqueserver now prints a warning in the console if being ran with an unsupported version of Python (e.g. 2.6)
• Various small fixes and improvements

Instalation from PyPi

Python 2.7 or 3.4+ and pip are required.

To install the latest version using pip3 (or pip2 for Python2) :

$ pip3 install --upgrade piqueserver # Installs latest piqueserver from PyPi

Installation with Docker

Please see our wiki page about Docker.

Installation from the source code

Python 2.7 or 3.4+, pip and virtualenv are required.

To build:

$ virtualenv -p python3 venv &&. ./venv/bin/activate # Activate virtualenv session
(venv) $ pip install -r requirements.txt             # Install requirements
(venv) $ python setup.py install                      # Build and install piqueserver
(venv) $ deactivate                                  # Deactivate virtualenv session

(replace -p python3 with -p python2 if you intend to run piqueserver in Python 2)

Running

You can specify the location of the configuration directory using the -d option. This allows you to have multiple configurations for different instances of piqueserver.

The default location is ~/.config/piqueserver/.

To run:

$ piqueserver # OR
$ piqueserver -d YOUR_CONFIGS_FOLDER_LOCATION

Piqueserver v0.1.0 RC

Installing this release

This pre-release can be installed with git clone (see README.md) or via pip:

pip install git+https://github.com/piqueserver/piqueserver@0.1.0-rc.1

Changes

Configuration Enhancements

You can now use the piqueserver --copy-config option to copy the default config to your configuration directory.

Scripts can now be loaded from the PYTHONPATH. This enables the installing and updating scripts with a single command, directly from pypi or github. No more abandoned scripts and lost patches! The goal is to make this even simpler next time.

Built-in Version Detection

Piqueserver now supports built-in version detection. It does not currently support enhanced version detection though.

Players can access version detection via the /client <username> command.

Scripters can access version detection via the connection.client_info dictionary.

Support for OpenSpades Popup Messages

OpenSpades supports new popup messages. These can be sent via the following functions:

connection.send_chat_notice(message)
connection.send_chat_warning(message)
connection.send_chat_error(message)
connection.send_chat_status(message)

protocol.broadcast_chat_notice(message, team=None)
protocol.broadcast_chat_warning(message, team=None)
protocol.broadcast_chat_error(message, team=None)
protocol.broadcast_chat_status(message, team=None)

Command System Rewrite

The commands system has been rewritten from scratch.
This is mainly a thing visible to script authors, but we managed to sneak in a few new features too:

• commands will now return a helpful error message when used incorrectly. No more "Invalid Command".
• commands taking player names will now refuse to work if multiple players match. No more accidental kicks of the wrong person.
• commands now accept "yes", "no", "on", "off" in addition to "0" and "1"

The new command interface can be used like this:

from piqueserver import commands

@commands.command()
def do_thing1(connection):
    do_thing1()

@commands.command("name", "alias", "another_alias", "even_more", "wew", "stop")
def do_thing2(connection):
    do_thing2()

Other Small Things

• 4-8x increase in map download speed
• merge several scripts into the base server (dynfog, bugfix.py, etc.)
• native support for bots
• merge changes from github.com/infogulch/pyspades
• update dependencies
  • now uses pyenet pypi package
  • now uses ipaddr pypi package
• various small fixes and improvements

Some users have managed to get piqueserver running under windows, but due to lack of testers and demand, we currently only have official support for Mac OS X (Darwin) and GNU/Linux. If you are a Window user please feel free to help us change this!

Instalation from PyPi

Python 2.7 and pip are required.

To install the latest version using pip:

$ pip install piqueserver # Installs latest piqueserver from PyPi

Installation from the source code

Python 2.7, pip and virtualenv are required.

To build:

$ virtualenv -p python2 venv &&. ./venv/bin/activate # Activate virtualenv session
(venv) $ pip install -r requirements.txt             # Install requirements
(venv) $ ./setup.py install                          # Build and install piqueserver
(venv) $ deactivate                                  # Deactivate virtualenv session

Running

You can specify the location of the configuration directory using the -d option. This allows you to have multiple configurations for different instances of piqueserver.

The default location is .config/piqueserver.

To run:

$ piqueserver # OR
$ piqueserver -d YOUR_CONFIGS_FOLDER_LOCATION

Docker support

Please see our wiki page about Docker.