Skip to content

docs(minecraft): sync 2026.7.0 default #379

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mberlofa merged 1 commit into from
Jul 7, 2026
+24 −15
Merged

docs(minecraft): sync 2026.7.0 default #379

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
7 changes: 7 additions & 0 deletions src/data/playground-configs.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7988,6 +7988,13 @@ export const chartConfigs: Record<string, ChartConfig> = {
default: '10Gi',
description: 'World data storage size',
},
{
label: 'Image Tag',
key: 'image.tag',
type: 'text',
default: '2026.7.0',
description: 'Minecraft server image tag',
},
],
},
{
Expand Down
31 changes: 16 additions & 15 deletions src/pages/docs/charts/minecraft.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ cross-play, mod and plugin management, Aikar-optimized JVM flags, and RCON-backe
- **Mod/plugin management** — Modrinth, CurseForge, Spiget, and direct URL downloads
- **Resource packs** — configure server-side resource packs with SHA-1 verification
- **Prometheus metrics** — mc-monitor sidecar with optional ServiceMonitor
- **Pinned upstream image** — defaults to `2026.5.4`, with Java-specific tags available when needed
- **Pinned upstream image** — defaults to `2026.7.0`, with Java-specific tags available when needed

## Installation

Expand All @@ -49,12 +49,12 @@ helm install minecraft oci://ghcr.io/helmforgedev/helm/minecraft --set server.eu

| Minecraft Version | Required Java | Example `image.tag` |
| ----------------- | ------------- | ------------------- |
| 1.21.5+ | Java 25 | `2026.5.4` |
| 1.20.x - 1.21.4 | Java 21 | `2026.5.4-java21` |
| 1.17.x - 1.19.x | Java 17 | `2026.5.4-java17` |
| 1.21.5+ | Java 25 | `2026.7.0` |
| 1.20.x - 1.21.4 | Java 21 | `2026.7.0-java21` |
| 1.17.x - 1.19.x | Java 17 | `2026.7.0-java17` |

The chart defaults to the dated upstream image tag `2026.5.4`. Pin `image.tag`
to a Java-specific variant, such as `2026.5.4-java21`, when running older
The chart defaults to the dated upstream image tag `2026.7.0`. Pin `image.tag`
to a Java-specific variant, such as `2026.7.0-java21`, when running older
Minecraft versions or modpacks that require a specific Java runtime.

## Server Type Reference
Expand Down Expand Up @@ -300,7 +300,7 @@ service:
| Parameter | Type | Default | Description |
| ------------------ | ------ | --------------------------------- | ------------------------------------------------------------------- |
| `image.repository` | string | `docker.io/itzg/minecraft-server` | Minecraft server container image. |
| `image.tag` | string | `"2026.5.4"` | Image tag. Use Java-specific variants for older Minecraft versions. |
| `image.tag` | string | `"2026.7.0"` | Image tag. Use Java-specific variants for older Minecraft versions. |
| `image.pullPolicy` | string | `IfNotPresent` | Image pull policy. |
| `imagePullSecrets` | array | `[]` | Pull secrets for private registries. |

Expand Down Expand Up @@ -442,7 +442,7 @@ upload — ensuring the world is in a consistent state before the backup is take
| `backup.backoffLimit` | integer | `1` | Job retry limit. |
| `backup.archivePrefix` | string | `minecraft` | Prefix for backup archive filenames. |
| `backup.excludes` | string | `"*.jar cache logs"` | Space-separated patterns excluded from the archive. |
| `backup.images.worker` | string | `docker.io/itzg/minecraft-server:2026.5.4` | Image for RCON and tar operations. |
| `backup.images.worker` | string | `docker.io/itzg/minecraft-server:2026.7.0` | Image for RCON and tar operations. |
| `backup.images.uploader` | string | `docker.io/helmforge/mc:1.0.0` | Image for S3 upload. |
| `backup.resources` | object | `{}` | Resources for backup containers. |
| `backup.s3.endpoint` | string | `""` | S3-compatible endpoint URL. |
Expand Down Expand Up @@ -511,13 +511,14 @@ upload — ensuring the world is in a consistent state before the backup is take

## Upgrade Notes

`docker.io/itzg/minecraft-server:2026.5.4` updates the upstream server image from
`2026.5.2`. The upstream releases include env-file loading at startup, server
library cleanup on Paper installs, helper/monitor/RCON dependency updates, and a
fix for deriving `MC_IMAGE_HELPER_OPTS` from `PROXY_*` variables. Review the
upstream release notes before upgrading production servers, take a world backup,
and verify plugins, mods, datapacks, proxy settings, and pinned `server.version`
values in a staging environment before reusing existing PVCs.
`docker.io/itzg/minecraft-server:2026.7.0` updates the upstream server image from
`2026.6.1`. The upstream release adds Purpur support for ServerLibraryCleaner,
fixes start-utils extraction for non-specific file types, fixes Paper boolean
flag handling, improves GTNH pack version handling, and reloads
`LOAD_ENV_FROM_FILE` after the packwiz installer runs.
Review the upstream release notes before upgrading production servers, take a
world backup, and verify plugins, mods, datapacks, proxy settings, and pinned
`server.version` values in a staging environment before reusing existing PVCs.

## More Information

Expand Down
1 change: 1 addition & 0 deletions src/pages/playground.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@ const siteSyncPlaygroundConfigs: Record<string, string> = {
memcached: 'src/data/playground-configs.ts',
memos: 'src/data/playground-configs.ts',
'metrics-server': 'src/data/playground-configs.ts',
minecraft: 'src/data/playground-configs.ts',
notediscovery: 'src/data/playground-configs.ts',
'oauth2-proxy': 'src/data/playground-configs.ts',
opencut: 'src/data/playground-configs.ts',
Expand Down