Sign inSign up

structs/structs-grass

By structs

•Updated 5 days ago

GRASS provides a constant real-time stream of all updates to the Structs game state.

Image
0

419

structs/structs-grass repository overview

⁠docker-structs-grass

Docker⁠ container for running the Guild Rapid Alert System Stream⁠.

Docker Hub: https://hub.docker.com/r/structs/structs-grass/⁠

⁠Structs

In the distant future the species of the galaxy are embroiled in a race for Alpha Matter, the rare and dangerous substance that fuels galactic civilization. Players take command of Structs, a race of sentient machines, and must forge alliances, conquer enemies and expand their influence to control Alpha Matter and the fate of the galaxy.

⁠How to Build

git clone [email protected]:playstructs/docker-structs-grass.git
cd docker-structs-grass
docker build --build-arg GRASS_REF="${GRASS_REF:?set GRASS_REF to the relay commit}" -t structs-grass:candidate .

Use a commit from the structs-grass remote when building a release candidate. Run the relay integration check against the built image. It uses disposable PostgreSQL and NATS containers, tests ordered delivery through a burst and a 135-second broker outage, then terminates the test LISTEN session and verifies the delivery probe after resubscription.

python3 tests/relay.py structs-grass:candidate

⁠How to Use this Image

⁠Quickstart

Set PG_CHANNEL, PG_CONNECTION and NAT_HOST in a private env file. Choose a Docker network from which both PostgreSQL and NATS are reachable and set GRASS_NETWORK to its name.

docker run -d --rm --name=structs-grass --network "$GRASS_NETWORK" --env-file .env.grass structs/structs-grass:latest

⁠Interactive

To follow the running relay:

docker logs -f structs-grass

⁠Learn more

⁠License

Copyright 2021 Slow Ninja Inc⁠.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0⁠

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

The influence relay is built as the whole Go package (go build .). It requires structs-pg through influence-grass-20261111 and its paired sync-state writer. INFLUENCE_ENABLED=true is the default; set it to false only when intentionally running the legacy notification path alone. INFLUENCE_DESTINATION=default is the persistent delivery-checkpoint name: keep it stable across restarts and use separate names for independent NATS destinations. The relay only needs publish permission for influence subjects; clients only subscribe. Initial loading and reconnect/gap recovery use the influence API. Normal grass updates contain complete data and require no API request. No JetStream configuration is required. Build a released relay commit containing influence.go.

Tag summary

Content type

Image

Digest

sha256:39d674b9c…

Size

865.3 MB

Last updated

5 days ago

docker pull structs/structs-grass