Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
55 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
d9a93ac
Revert "clean"
dc-redeclipse Jan 18, 2026
59655a4
add maps submodule
dc-redeclipse Jan 18, 2026
0fd9c46
Add game state, platform and arch to the server browser
dc-redeclipse Feb 7, 2026
738c747
Create run_script.yml
dc-redeclipse Feb 18, 2026
0f3ed3e
Update run_script.yml
dc-redeclipse Feb 19, 2026
7b3ed59
Update run_script.yml
dc-redeclipse Feb 19, 2026
3aa2316
Update run_script.yml
dc-redeclipse Feb 22, 2026
7765f20
add social links
dc-redeclipse Feb 23, 2026
c5f80a5
Fix submodule pointer for bits
dc-redeclipse Jun 28, 2026
9ebccbb
Update Install-Guide.md
dc-redeclipse Jun 28, 2026
817af17
Update Install-Guide.md
dc-redeclipse Jun 28, 2026
e82c720
remove docs
dc-redeclipse Aug 19, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
44 changes: 44 additions & 0 deletions .github/workflows/run_script.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
name: Execute Server Polling Script

on:
schedule:
- cron: '0 * * * *'
workflow_dispatch:

jobs:
run-python-loop:
runs-on: ubuntu-latest

steps:
- name: Checkout code
uses: actions/checkout@v4

- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: '3.x'

- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install python-dotenv
pip install -r requirements.txt

- name: Run Execution Loop
run: |
# We embed your bash logic directly here
SCRIPT_NAME="getservers.py"
RUN_COUNT=5
WAIT_TIME=30

echo "Starting execution loop..."
for (( i=1; i<=RUN_COUNT; i++ ))
do
echo "--- Run #$i of $RUN_COUNT ---"
python3 "$SCRIPT_NAME"

if [ $i -lt $RUN_COUNT ]; then
echo "Waiting $WAIT_TIME seconds..."
sleep $WAIT_TIME
fi
done
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
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"
34 changes: 0 additions & 34 deletions docs/AppImages.md

This file was deleted.

67 changes: 0 additions & 67 deletions docs/Contributing.md

This file was deleted.

Loading