Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
43 commits
Select commit Hold shift + click to select a range
2f57d8d
Update _config.yml
dc-redeclipse Nov 16, 2025
da238a6
Update _config.yml
dc-redeclipse Nov 16, 2025
92f8489
Update _config.yml
dc-redeclipse Nov 16, 2025
8e6a789
Update _config.yml
dc-redeclipse Nov 16, 2025
1530ea5
Update _config.yml
dc-redeclipse Nov 16, 2025
21e825d
Update _config.yml
dc-redeclipse Nov 17, 2025
48bb5e1
first push
dc-redeclipse Nov 18, 2025
aa91ae2
Update index.html
dc-redeclipse Nov 19, 2025
7f7dee8
Update index.html
dc-redeclipse Nov 19, 2025
ec3c245
v01
dc-redeclipse Nov 19, 2025
cdc5b18
homepage update for 2.1 (v0.1)
dc-redeclipse Nov 19, 2025
ff20044
updated to cover
dc-redeclipse Nov 19, 2025
62ee9f7
fin
dc-redeclipse Nov 19, 2025
1e08cec
up
dc-redeclipse Nov 19, 2025
84c43b0
Update index.html
dc-redeclipse Nov 19, 2025
c707ed4
Update index.html
dc-redeclipse Nov 19, 2025
ebc4b9d
Update index.html
dc-redeclipse Nov 19, 2025
391b7ab
Big Bang
dc-redeclipse Nov 19, 2025
1b85baf
Update _config.yml
dc-redeclipse Nov 19, 2025
4ac8c4d
Update index.html
dc-redeclipse Nov 20, 2025
04dc2dd
little fix in Update _config.yml
dc-redeclipse Nov 20, 2025
7a44e4e
Update _config.yml
dc-redeclipse Nov 20, 2025
08ed1ea
Update index.html
dc-redeclipse Nov 21, 2025
716e602
Merge branch 'master' of https://github.com/dc-redeclipse/redeclipse.…
dc-redeclipse Nov 21, 2025
47c6fc8
Update index.html
dc-redeclipse Nov 21, 2025
06c415e
Update index.html
dc-redeclipse Nov 21, 2025
d46a95a
Update index.html
dc-redeclipse Nov 21, 2025
5cf7e8a
Update index.html
dc-redeclipse Nov 21, 2025
56369d6
fix
dc-redeclipse Nov 21, 2025
60bb6e3
Update index.html
dc-redeclipse Nov 21, 2025
34251a4
Update index.html
dc-redeclipse Nov 22, 2025
6417f23
Update index.html
dc-redeclipse Nov 22, 2025
60b460c
Update index.html
dc-redeclipse Nov 22, 2025
dfd3157
updated crosshair and download
dc-redeclipse Dec 1, 2025
35ad364
Update index.html
dc-redeclipse Dec 1, 2025
d8ffe1c
Update index.html
dc-redeclipse Dec 3, 2025
369e422
Update index.html
dc-redeclipse Dec 4, 2025
bbb6212
change www.redeclipse.net to redeclipse.net
dc-redeclipse Dec 4, 2025
552a23f
add Important Notice About Unofficial Packages
dc-redeclipse Dec 11, 2025
26d3f91
Big Bang Homepage Update + NEW Server browser
dc-redeclipse Jan 13, 2026
c09705e
Update bits
dc-redeclipse Jan 13, 2026
d598518
little fix
dc-redeclipse Jan 13, 2026
e1e5a6c
clean
dc-redeclipse Jan 13, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,7 @@ data/local.yml
*.rej
*.bak
*.kate-swp

.env
__pycache__/
*.py[cod]
data/*.json
4 changes: 4 additions & 0 deletions .gitmodules
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
[submodule "bits"]
path = bits
url = https://github.com/redeclipse/www-bits.git

[submodule "maps"]
path = maps
url = https://github.com/redeclipse/maps.git
2 changes: 1 addition & 1 deletion 404.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ The page you were looking for could not be found. Please check the URL and try a

If you continue to have problems, try starting from the **[Home Page](/)**.

You can get further help from our **[Documentation](/docs/Home)**, **[Live Chat](/chat)**, or **[Discussion Area](/discuss)**.
You can get further help from our **[Documentation](/docs/Home)**, **[Discord](/discord)**, or **[Discussion Area](/discuss)**.
2 changes: 1 addition & 1 deletion CNAME
Original file line number Diff line number Diff line change
@@ -1 +1 @@
www.redeclipse.net
redeclipse.net
87 changes: 85 additions & 2 deletions Readme.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
Welcome to the Red Eclipse Website repository. This is a work in progress to update the website in preparation for v2.0.
Welcome to the Red Eclipse Website repository. This is a work in progress to update the website in preparation for v2.1.

This repository is automatically deployed by [GitHub Pages](https://pages.github.com/) to our [Website](https://www.redeclipse.net/) and includes pages built from the [Documentation Repository](https://github.com/redeclipse/docs).
This repository is automatically deployed by [GitHub Pages](https://pages.github.com/) to our [Website](https://redeclipse.net/) and includes pages built from the [Documentation Repository](https://github.com/redeclipse/docs).

When editing pages here, there are a few guidelines you should follow. It is also important to understand how the pre-processors work, like [Jekyll](https://jekyllrb.com/docs/home/) and [Kramdown](https://kramdown.gettalong.org/documentation.html). The configuration for everything is held in [_config.yml](https://github.com/redeclipse/redeclipse.github.io/blob/master/_config.yml).

Expand Down Expand Up @@ -76,3 +76,86 @@ All paths need to be relative to each other. The docs repository is converted to
### Table of Contents
Kramdown supports the automatic generation of these, and the pages are automatically generated to include them. You do **not** need to create your own at the top of your pages.


# Server browser

The system operates in a multi-stage process to minimize the load on the Master server while ensuring maximum data accuracy.


### 1. Python Poller (Backend)
The **Python Poller** acts as the heart of the system:
* **Master Discovery:** It retrieves the list of all active server IPs from the Red Eclipse Master Server.
* **UDP Queries:** The data is retrieved via **UDP** to get live stats and data.
* **JSON Output:** Collected data is saved into structured **JSON files**. This decouples data collection from the display, ensuring the website stays fast.

### 2. Server browser (Frontend)
The **Frontend** serves as the user interface for the community:
* The Server browser on the homepage parses the generated JSON files.
* Data is rendered into a user-friendly, responsive layout.
* Players can see exactly where the action is without needing to open the game client.

### 3. Notifications
Beyond just displaying data, the system includes a **Threshold-based Notification Mode**:
* **Threshold Check:** The poller monitors player counts against a set limit (e.g., "Notify when 4+ players are online").
* **Trigger:** Once the player count hits the threshold, the system triggers a notification (Browser notification or Discord Webhook).

---

## System Benefits

* **Efficiency:** UDP pings and JSON caching keep web performance high, regardless of game server response times.
* **Automation:** Players don't have to manually refresh; the system "calls" the community when a player joins.
* **Mobile Ready:** The frontend is optimized so that server lists and stats remain perfectly readable on smartphones.

---


# Running the Homepage (Jekyll)

The website is built using **Jekyll**, a Ruby-based static site generator. Ensure **Ruby** and **RubyGems** are installed on your system.

## Installing

Clone the git repository and navigate to the top-level directory. Install the dependencies using Bundler:

bundle install

*Note: If you don't have Bundler, install it first with `gem install bundler`.*

## Running

To launch the local development server, run:

bundle exec jekyll serve --watch

By default, the web UI will be available at `http://localhost:4000`. Jekyll will automatically watch for file changes and regenerate the site.

---

# Running the Server Browser (Python poller)

The data poller is a **Python** application. Ensure **Python 3.8+** is installed.

## Installing

Clone the repository containing the poller and install the necessary Python packages:

pip install -r requirements.txt

## Running

The poller communicates with the master server via UDP and generates the JSON data used by the frontend. Run it with:

python3 getservers.py

### Advanced Usage

To enable the legacy notification mode (watching for player thresholds) and debug output:

python3 getservers.py [-h] [-d]

options:
-h, --help show this help message and exit
-d, --debug

By default, the script writes its JSON output to the directory used by the homepage. Edit the configuration variables at the top of `getservers.py` or provide command-line arguments to change paths and notification thresholds.
6 changes: 5 additions & 1 deletion _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,12 +23,16 @@ exclude:
- ".github"
- "plugins"
- "layouts"
- "data"
- "includes"
- "_config.yml"
- "CNAME"
- "Gemfile"
- "Gemfile.lock"
- ".env"

keep_files:
- "notify.json"

encoding: "utf-8"
markdown_ext: "markdown,mkdown,mkdn,mkd,md"
strict_front_matter: false
Expand Down
1 change: 0 additions & 1 deletion bits
Submodule bits deleted from fd19b6
9 changes: 0 additions & 9 deletions data/extlinks.yml
Original file line number Diff line number Diff line change
@@ -1,12 +1,3 @@
- url: /github
title: "GitHub"
class: "fab fa-github"
- url: /discord
title: "Discord"
class: "fab fa-discord"
- url: /steam
title: "Steam"
class: "fab fa-steam"
- url: /reddit
title: "Reddit"
class: "fab fa-reddit"
Expand Down
11 changes: 7 additions & 4 deletions data/game.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,11 @@
version: "2.0.0"
release: "Jupiter Edition"
date: "19th December 2019"
version: "2.0.9"
release: "Big Bang Beta"
date: "24th December 2025"
#version: "2.1.0"
#release: "Big Bang Edition"
#date: "24th December 2026"
youtube: p7w4LXJ_JJ8
copyright: "2009-2020 Quinton Reeves, Lee Salzman"
copyright: "Quinton Reeves, Lee Salzman"
screenshots:
pages: 20
items: 4
15 changes: 12 additions & 3 deletions data/navigation.yml
Original file line number Diff line number Diff line change
@@ -1,15 +1,24 @@
- url: /steam
title: "Steam"
class: "fab fa-steam"
- url: /discord
title: "Discord"
class: "fab fa-discord"
- url: /servers
title: "Server browser"
class: "fas fa-server"
- url: /download
title: "Downloads"
class: "fas fa-download"
- url: /docs
title: "Documentation"
class: "fas fa-book"
- url: /github
title: "GitHub"
class: "fab fa-github"
- url: /discuss
title: "Discussions"
class: "fas fa-comment"
- url: /issues
title: "Issue Tracker"
class: "fas fa-tasks"
- url: /servers
title: "Server List"
class: "fas fa-server"
16 changes: 8 additions & 8 deletions docs/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,11 +95,11 @@ On Windows, when Red Eclipse detects the renderer as 'GDI Generic' it will repor

## Can I contribute to the game?

Development of Red Eclipse is open and community driven. Contributions can be maps created with the in-game ~~[editor](Editing-Basics)~~, art assets like models, or modifications of the [source code](https://github.com/redeclipse/base/tree/master/src). For further information, please read our [contribution guidelines](Contributing).
Development of Red Eclipse is open and community driven. Contributions can be maps created with the in-game [editor](editing/Basics), art assets like models, or modifications of the [source code](https://github.com/redeclipse/base/tree/master/src). For further information, please read our [contribution guidelines](Contributing).

## I found a cheater, what can I do?

If you think someone cheats or violates the [Multiplayer Guidelines](https://raw.githubusercontent.com/redeclipse/base/master/doc/guidelines.txt) in some other way, you can open a issue in the [discussion area](/discuss). Be sure to attach a ~~[demo](Demo-Guide)~~ record of the game, so the problem can be investigated. Convictable cheaters will be sanctioned accordingly.
If you think someone cheats or violates the [Multiplayer Guidelines](https://raw.githubusercontent.com/redeclipse/base/master/doc/guidelines.txt) in some other way, you can open a issue in the [discussion area](/discuss). Be sure to attach a demo record of the game, so the problem can be investigated. Convictable cheaters will be sanctioned accordingly.

## How can i change the chat colour?

Expand All @@ -109,19 +109,19 @@ Only use bright colours with good contrast. A value of -1 will take your profile

## What is the game objective?

This depends on the current ~~[mode and mutators](Modes-and-Mutators)~~ of the game, which you can look up any time in the help menu (default key: **F1**). Click the large icons in the help menu to learn more about the rules of the current game. These help menus provide detailed information and tips, of which most can also be read on the wiki. There is also a ~~[guide](Gameplay-Guide)~~ for beginners.
This depends on the current [mode and mutators](gameplay/Gameplay-Guide) of the game, which you can look up any time in the help menu (default key: **F1**). Click the large icons in the help menu to learn more about the rules of the current game. These help menus provide detailed information and tips, of which most can also be read on the wiki. There is also a [guide](gameplay/Gameplay-Guide) for beginners.

## Why is my player score negative?

Be careful not to shoot your team mates, especially when using explosive weapons. Each team kill subtracts six points. Team kills on ~~[flag carriers](Capture-the-Flag)~~ or ~~[bombers](Bomber-ball)~~ even double this penalty. For details, see [Deathmatch Scoring](Deathmatch#scoring).
Be careful not to shoot your team mates, especially when using explosive weapons. Each team kill subtracts six points. Team kills on [flag carriers](gameplay/Capture-the-Flag) or Bomber-ball even double this penalty. For details, see [Deathmatch Scoring](gameplay/Gameplay-Guide).

## dm, pzap, gg - what did they just say?

For frequently used abbreviations and player slang, see [glossary](Glossary).

## What are those symbols near player names?

These are the ~~[privileges](Privileges)~~ or ranks of registered players. You can request your own player account [here](/apply).
These are the Privileges or ranks of registered players.

## Why is there a timer when I get killed?

Expand All @@ -133,15 +133,15 @@ It is easy to hit someone with a shotgun, but the weapon is really only effectiv

## How did they take away their own flag?

In ~~[capture](Capture-the-Flag)~~ games, you can press **F** (per default) to pick up the flag in your own base, so the enemy cannot reach it that easily. The same button can also be used to drop a flag you carry, be it yours or the enemy's.
In [capture](gameplay/Capture-the-Flag) games, you can press **F** (per default) to pick up the flag in your own base, so the enemy cannot reach it that easily. The same button can also be used to drop a flag you carry, be it yours or the enemy's.

## Why are there no health pickups?

In Red Eclipse the player regenerates health and ~~[impulse](Parkour-Guide)~~ energy. Therefore, map control is less important, and everyone can focus on the real fun: Capturing that flag, grabbing that bomber ball… or just fragging!
In Red Eclipse the player regenerates health and [impulse](gameplay/Parkour-Guide) energy. Therefore, map control is less important, and everyone can focus on the real fun: Capturing that flag, grabbing that bomber ball… or just fragging!

## Why am I taking damage when no one is near me?

Your are under the effect of the a negative ~~[status effect](Status-Effects)~~.
Your are under the effect of the a negative Status-Effects.

## A green beeping thing obscured my vision - what the heck?

Expand Down
6 changes: 3 additions & 3 deletions docs/Glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ The following list explains some commonly used terms and acronyms.
| term | Description |
|--------|-------------|
| afk | away from keyboard. When spectators go AFK, they can and should alter their /name accordingly. Going AFK on a nearly full server can result in a kick. |
| auth | authentication, a key for registered players to identify. Often used as synonym for player accounts or ~~[privileges](Privileges)~~. |
| auth | authentication, a key for registered players to identify. Often used as synonym for player accounts or Privileges. |
| bb | bomber-ball, a game mode. Or bye bye. |
| bot | usually refers to an A.I. controlled player. Not to confuse with aim-bot, a client side modification that is considered cheating according to the Multiplayer Guidelines. |
| cc | creative-commons license, typically used for licensing of contributions. |
Expand All @@ -30,12 +30,12 @@ The following list explains some commonly used terms and acronyms.
| gaud | the official unit for gaudiness. 100° C is hot enough to vaporize your eyeballs; likewise 100 gaud is gaudy enough to do the same. For an example of a 100-gaud map, see Map Rooftop |
| insta | instagib, a game mutator for one-hit-kills, disabled by default. |
| mat | materials define special properties of map volumes, such as filling an area with water or clipping. |
| mod | moderator, a player with elevated ~~[privileges](Privileges)~~. Mod can also stand for client modifications. |
| mod | moderator, a player with elevated Privileges. Mod can also stand for client modifications. |
| mpz | file format to store most content of a map, including all geometry, entity positions and lightmaps. |
| muts | game mutators, special game rules that can be added and combined for a more diverse game experience. |
| nade | grenade, a collectible explosive weapon. |
| ogg | container format for vorbis audio, used for music and sound files. |
| op | operator, a player with advanced ~~[privileges](Privileges)~~. Or just OverPowered. |
| op | operator, a player with advanced Privileges. Or just OverPowered. |
| pzap | a typical taunt or chat comment, echoism of a rifle shot. |
| runner | players with a preference for parkour and agile game-play, like race games or hit-and-run tactics in capture-the-flag or bomber-ball games. |
| sg | shotgun, a short ranged loadout weapon. |
Expand Down
8 changes: 1 addition & 7 deletions docs/Home.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,6 @@ redirect_from:
- **[Gameplay Guide](gameplay/Gameplay-Guide)** - Want to learn how to play? This is a good start.
- **[Learn about the Weapons](gameplay/Weapons-Guide)** - Each weapon is unique, learn the pros and cons.
- **[Tips and Tricks for using Parkour](gameplay/Parkour-Guide)** - Everyone loves running on walls, but there's more to learn.
- **[Official Maps](Official-Maps)** - Descriptions and recommendations for the included levels.

## Server Administration
- **[Server Setup](server-how-to/Server-Setup)** - How to configure and run a Red Eclipse server.
Expand All @@ -29,10 +28,8 @@ redirect_from:

## Map Editing
- **[Editing Basics](editing/Basics)** - Learn how to start making your own maps in Red Eclipse.
- **~~[Editing Reference](editing/Reference)~~** - A detailed explanation of the available editor features.

## Development
- **[Version 2.0](Information-for-v2)** - Find out more about the upcoming **v2.0**, featuring [Tesseract](http://tesseract.gg/).
- **[Contributing](Contributing)** - Instructions on contributing to the Red Eclipse project.
- **[Core Principles](Core-Principles)** - Some of the ideas that shape how Red Eclipse as a game is designed.
- **[Debugging](Debug)** - How to gather information for debugging.
Expand All @@ -44,12 +41,9 @@ redirect_from:
- **[Facebook Messenger](/messenger)** - Ask a quick question and we'll get back to you.
- **[Issue Tracker](/issues)** - The place for bug reports and approved feature requests.
- **[Contribution Guidelines](/contribute)** - See our rules and suggestions for contributing.
- **[Game Statistics](/stats)** - The place to see statistics collected by our master server.
- **[Server List](/servers)** - See a nice list of server and who's playing on them.
- **[Official SubReddit](/reddit)** - The place to share with your fellow Reddit'ors.
- **[GameJolt Page](/gamejolt)** - Leave us a review or use the GameJolt client to manage your game.
- **[Facebook Page](/facebook)** - Get social with our Facebook page and share your review of the game.
- **[YouTube Page](/youtube)** - The place to see Red Eclipse related videos and live streams.
- **[GitHub Project](/github)** - We do all our development on GitHub, so this is the place to start when developing.
- **[Subscribe via Patreon](/patreon)** - Pledge to our Patreon in order to help cover project costs.
- **[Sponsor via Open Collective](/opencollective)** - Sponsor the project and help cover project costs.
- **[Donate via PayPal](/paypal)** - Make a one-time or recurring donation to help cover project costs.
15 changes: 6 additions & 9 deletions docs/Install-Guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,14 +43,11 @@ From the command line:
- Enter the source directory with `cd src`
- Run the game with `./redeclipse.sh`

## macOS
- [Download the macOS tarball](/download/macos).
- When it is done, click the resulting TAR.BZ2 file in your downloads folder on the dock.
- Archive utility will extract the contents into the same folder and open a Finder window with redeclipse.app highlighted.
- Drag and drop the redeclipse.app package to your favourite location (Desktop, Applications folder, whatever).
- Run redeclipse.app.

If this is the first time running the app, the operating system complains that it can't run an unsigned package, simply right (or cmd) click and select Open. In future you will be able to run the app as normal, this will override the warning for all future attempts. You can also do this from the command line.

## If you get stuck
Don't panic! If you have trouble working out how to install and run the game, you can get assistance on our [Discord](/discord) or [Discussions](/discuss). Please be ready to provide as much information as possible, especially what operating system you're on and specifically which package you're trying to install!

## Important Notice About Unofficial Packages
Red Eclipse is available only through the official installation methods described on this page or via **[Steam](/steam)**.
Packages found on Flathub, Snap, Flatpak, AUR, Linux distribution repositories, the Ubuntu Software Store, or any other third-party source are not official, not maintained, and not supported by the Red Eclipse development team.h
These unofficial packages may be outdated, incomplete, or insecure, and can cause issues that we cannot assist with.
For the best experience and to ensure you're receiving verified, up-to-date builds, please install Red Eclipse exclusively through the official methods provided here or via **[Steam](/steam)**.
Loading