itzg / itzg/docker-minecraft-server

docs(kubernetes): suggest the use of an init container to download mods which disallow project distribution

Open
#2,174 3 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

documentation enhancement
Dominant language
Shell
Stars
14.3k
Forks
1.9k
Avg merge
2d 10h
Merged PRs (30d)
31

Description

### Enhancement Type

Improve an existing feature

### Describe the enhancement

Some mods disallow project distribution and have to be download manually. This can be tricky for containerised environments, especially for Kubernetes. It might be nice to document the use of an init container to download these assets automatically. See what I've done as an example [here](https://github.com/uhthomas/automata/blob/b65328f8f51ac8e8e353551749466e3ee2844b72/k8s/unwind/minecraft/cf_atm8/stateful_set_list.cue#L36-L61).

It might also be possible to write something quick for Docker compose too?

```
minecraft-cf-atm8-0 minecraft-server [mc-image-helper] 12:20:47.139 WARN : The authors of the mod 'Fix Experience Bug (now with FABRIC and FORGE versions)' have disallowed project distribution. Manually download the file 'ExperienceBugFix-1.19-1.41.2.3.jar' from https://www.curseforge.com/minecraft/mc-mods/fix-experience-bug and supply the mod file separately.
minecraft-cf-atm8-0 minecraft-server [mc-image-helper] 12:20:45.911 WARN : The authors of the mod 'More Overlays Updated' have disallowed project distribution. Manually download the file '[1.19.2] MoreOverlays 1.21.5' from https://www.curseforge.com/minecraft/mc-mods/more-overlays-updated and supply the mod file separately.
minecraft-cf-atm8-0 minecraft-server [mc-image-helper] 12:20:47.165 WARN : The authors of the mod 'Hexerei' have disallowed project distribution. Manually download the file 'hexerei-0.3.0.jar' from https://www.curseforge.com/minecraft/mc-mods/hexerei and supply the mod file separately.
```

The linked example rendered as yaml:

```yaml
initContainers:
- name: download
image: curlimages/curl:8.1.1
args:
- -C
- '-'
- -LOf
- '{https://mediafilez.forgecdn.net/files/4178/188/ExperienceBugFix-1.19-1.41.2.3.jar,https://mediafilez.forgecdn.net/files/4322/445/moreoverlays-1.21.5-mc1.19.2.jar,https://mediafilez.forgecdn.net/files/4466/686/hexerei-0.3.0.jar}'
workingDir: /downloads
resources:
limits:
cpu: "1"
memory: 1Gi
volumeMounts:
- name: downloads
mountPath: /downloads
imagePullPolicy: IfNotPresent
securityContext:
capabilities:
drop:
- ALL
readOnlyRootFilesystem: true
allowPrivilegeEscalation: false
```

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Locate the repository's Kubernetes documentation and any Docker Compose guidance, then compare their existing patterns with the linked stateful_set_list.cue example. Document how users can use an init container to download manually supplied mod assets, and clarify whether a Docker Compose example is in scope; done means the relevant containerized deployment guidance is complete and understandable.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker-compose, kubernetes
Domain
devops, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.