https://github.com/allejo/playerjoinhandler

A BZFlag plug-in to help avoid disruptions during matches
https://github.com/allejo/playerjoinhandler

bzflag bzflag-plugin

Last synced: 6 months ago
JSON representation

A BZFlag plug-in to help avoid disruptions during matches

• Host: GitHub
• URL: https://github.com/allejo/playerjoinhandler
• Owner: allejo
• License: mit
• Created: 2015-11-11T04:55:07.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2017-01-09T20:52:21.000Z (almost 9 years ago)
• Last Synced: 2025-03-04T18:41:19.142Z (10 months ago)
• Topics: bzflag, bzflag-plugin
• Language: C++
• Homepage:
• Size: 12.7 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# Player Join Handler

[![GitHub release](https://img.shields.io/github/release/allejo/playerJoinHandler.svg?maxAge=2592000)](https://github.com/allejo/playerJoinHandler/releases/latest)

![Minimum BZFlag Version](https://img.shields.io/badge/BZFlag-v2.4.0+-blue.svg)

[![License](https://img.shields.io/github/license/allejo/playerJoinHandler.svg)](https://github.com/allejo/playerJoinHandler/blob/master/LICENSE.md)

A BZFlag plug-in that keeps track of player sessions and automatically moves players to the observer team if a match is in progress and they were not already on the server.

A session exists the entire time a player is on the server plus 120 seconds (this can be configured through `_sessionTime`) after they have disconnected. If a match is in progress, players will only be able to join while their session is still active. By default, unverified players cannot join a match even if they have a session; this can be disabled by settings `_allowUnverified` to true.

## Usage

**Loading the plug-in**

This plug-in does not take any command line parameters; everything is configured through BZDB variables.

```

-loadplugin playerJoinHandler

```

**Custom BZDB Variables**

These custom BZDB variables must be used with `-setforced`, which sets BZDB variable `` to ``, even if the variable does not exist.

```

-setforced  

```

| Name               | Type | Default | Description |

| ------------------ | ---- | ------- | ----------- |

| `_sessionTime`     | int  | 120     | The amount of seconds a player has to move from observer to a tank, a session |

| `_allowUnverified` | bool | false   | When set to true, unregistered players will be able to join a match if they already have a session |

## License

MIT