OVCR World Chooser

OVCR World Chooser

Français plus bas.

OVCR World Chooser shows a full-screen menu the first time a player joins a world, so they can pick where their survival starts. It was made for OVCR, a NeoForge 1.21.1 survival modpack that offers two starting worlds: Ruined Cities (the Overworld, full of abandoned cities generated by The Lost Cities) and Wildlands (a separate dimension of untouched nature with no cities). The player picks one of two illustrated cards, confirms, and the modpack's server script sends them there.

What the player sees

• On first join, once the world has loaded, a full-screen menu opens over the blurred game scene.
• Two large illustrated cards side by side: Ruined Cities and Wildlands, each with a short description and three key points (for example "No cities, roads or rails" or "Filled chests in the buildings").
• The player clicks a card to select it, then clicks Confirm. Two steps, so nobody picks by accident.
• Esc asks "Choose later?". Choosing later closes the menu and the player stays in the Ruined Cities for now; the menu comes back at the next join, or with /ovcrmonde.
• After confirming, the menu fades out and the player is moved to the chosen world. It does not open again on later joins. In OVCR, players can still switch worlds later with a bed placed on crying obsidian.

Features

• Layout adapts to every window: cards side by side, stacked or compacted on small windows. Checked for GUI scales 1 to 4 and Auto, from 854×480 to ultra-wide screens.
• Keyboard support: ← → to choose, Tab to move between buttons, Enter to confirm, Esc for "Choose later?".
• Smooth animations based on the clock, with no fast flashing. Narrator support.
• English and French text.
• Safe while choosing: for a short time the player takes no damage and mobs cannot target them, so nobody dies while reading the menu. This protection lasts 3 minutes at most, is given once per connection, only near the world spawn, and ends at the first action (moving, attacking, breaking, using an item, changing dimension).
• The server never trusts the client: the client only sends which card was chosen (or "later"), never coordinates or a dimension. The server checks the player, that it really opened the menu for them, the value and a rate limit.
• Optional for players: someone without the mod can still join the server; the modpack then shows its own fallback (clickable chat buttons in OVCR).

Requirements

• Minecraft 1.21.1, NeoForge 21.1 or newer, Java 21
• KubeJS (required: the mod reads the player's KubeJS persistent data)
• Install on the server and on the clients.

Who is this mod for

This mod is the menu only: it does not teleport anyone and does not add dimensions. The travel, the dimensions and the "has this player chosen?" flag belong to the modpack's server script. It works out of the box in OVCR. Another modpack can use it if its KubeJS server script follows the same contract:

1. On join, if persistentData.ovcrWorldChosen is false, the script runs /ovcrchooser login <player>. If the client has the mod, the menu opens and persistentData.ovcrChooserSent is set (the script reads it, then clears it); otherwise the script shows its own fallback.
2. When the player confirms, the server runs /ovcrmonde villes (Ruined Cities) or /ovcrmonde sauvages (Wildlands) as the player. The script registers that command, does the travel and sets ovcrWorldChosen.
3. 10 ticks later the mod checks ovcrWorldChosen. If it is still false (for example no safe ground was found), the menu opens again with a "No safe ground found" message.

Admin commands (operator level 2): /ovcrchooser info <player> (state of the player), /ovcrchooser open <player> (open the menu), /ovcrchooser login <player> (used by the script on join), /ovcrchooser open <player> erreur (test the error message).

FAQ

• Does it work without the OVCR modpack? Only with a server script that provides /ovcrmonde and the ovcrWorldChosen flag, as described above. On its own, it does nothing.
• Does it change world generation? No. It adds no blocks, items, dimensions or world generation.
• Is anything saved in the world? No. The protection is kept in memory only; the choice itself is saved by the modpack's script.

License

MIT. The card pictures are in-game screenshots from the OVCR modpack.

OVCR World Chooser (français)

OVCR World Chooser affiche un menu plein écran à la première connexion d'un joueur, pour qu'il choisisse où commence sa survie. Il a été fait pour OVCR, un modpack de survie NeoForge 1.21.1 qui propose deux mondes de départ : les Villes en ruines (l'Overworld, rempli de villes abandonnées générées par The Lost Cities) et les Terres sauvages (une dimension à part, nature intacte, sans villes). Le joueur choisit l'une des deux cartes illustrées, confirme, et le script serveur du modpack l'y envoie.

Ce que voit le joueur

• À la première connexion, une fois le monde chargé, un menu plein écran s'ouvre sur la scène du jeu floutée.
• Deux grandes cartes illustrées côte à côte : Villes en ruines et Terres sauvages, chacune avec une courte description et trois points clés (par exemple « Ni villes, ni routes, ni rails » ou « Coffres remplis dans les bâtiments »).
• Un clic sélectionne une carte, puis Confirmer valide. Deux temps, pour que personne ne choisisse par erreur.
• Échap propose « Choisir plus tard ? ». « Plus tard » ferme le menu et le joueur reste pour l'instant dans les Villes en ruines ; le menu revient à la connexion suivante, ou avec /ovcrmonde.
• Après confirmation, le menu disparaît en fondu et le joueur part dans le monde choisi. Le menu ne revient plus aux connexions suivantes. Dans OVCR, on peut encore changer de monde plus tard avec un lit posé sur de l'obsidienne pleureuse.

Fonctions

• Mise en page adaptée à chaque fenêtre : cartes côte à côte, empilées ou compactées sur petite fenêtre. Contrôlée aux échelles GUI 1 à 4 et Auto, de 854×480 à l'ultra-large.
• Clavier : ← → pour choisir, Tab pour passer d'un bouton à l'autre, Entrée pour valider, Échap pour « Choisir plus tard ? ».
• Animations douces réglées sur l'horloge, rien qui clignote vite. Narrateur pris en charge.
• Textes en français et en anglais.
• En sécurité pendant le choix : pendant un court moment, le joueur ne prend aucun dégât et les monstres ne peuvent pas le cibler, pour que personne ne meure en lisant le menu. Cette protection dure 3 minutes au plus, n'est donnée qu'une fois par connexion, seulement près du spawn, et s'arrête à la première action (déplacement, attaque, casse, utilisation d'un objet, changement de dimension).
• Le serveur ne fait pas confiance au client : le client n'envoie que la carte choisie (ou « plus tard »), jamais de coordonnées ni de dimension. Le serveur vérifie le joueur, que le menu lui a bien été ouvert, la valeur et la cadence.
• Facultatif pour les joueurs : un joueur sans le mod peut quand même rejoindre le serveur ; le modpack affiche alors son propre repli (des boutons cliquables dans le chat, dans OVCR).

Prérequis

• Minecraft 1.21.1, NeoForge 21.1 ou plus récent, Java 21
• KubeJS (obligatoire : le mod lit les données persistantes KubeJS du joueur)
• À installer sur le serveur et les clients.

À qui s'adresse ce mod

Ce mod n'est que le menu : il ne téléporte personne et n'ajoute aucune dimension. Le voyage, les dimensions et le drapeau « ce joueur a-t-il choisi ? » appartiennent au script serveur du modpack. Il marche tel quel dans OVCR. Un autre modpack peut l'utiliser si son script serveur KubeJS respecte le même contrat :

1. À la connexion, si persistentData.ovcrWorldChosen est faux, le script lance /ovcrchooser login <joueur>. Si le client a le mod, le menu s'ouvre et persistentData.ovcrChooserSent est posé (le script le lit puis l'efface) ; sinon, le script affiche son propre repli.
2. Quand le joueur confirme, le serveur lance /ovcrmonde villes (Villes en ruines) ou /ovcrmonde sauvages (Terres sauvages) au nom du joueur. Le script déclare cette commande, fait le voyage et pose ovcrWorldChosen.
3. 10 ticks plus tard, le mod contrôle ovcrWorldChosen. S'il est toujours faux (par exemple aucun sol sûr trouvé), le menu revient avec le message « Aucun sol sûr trouvé ».

Commandes d'administration (opérateur niveau 2) : /ovcrchooser info <joueur> (état du joueur), /ovcrchooser open <joueur> (ouvrir le menu), /ovcrchooser login <joueur> (utilisée par le script à la connexion), /ovcrchooser open <joueur> erreur (tester le message d'erreur).

Questions fréquentes

• Est-ce qu'il marche sans le modpack OVCR ? Seulement avec un script serveur qui fournit /ovcrmonde et le drapeau ovcrWorldChosen, comme décrit plus haut. Seul, il ne fait rien.
• Est-ce qu'il change la génération du monde ? Non. Il n'ajoute ni bloc, ni objet, ni dimension, ni génération.
• Est-ce qu'il enregistre quelque chose dans le monde ? Non. La protection est gardée en mémoire seulement ; le choix lui-même est enregistré par le script du modpack.

Licence

MIT. Les images des cartes sont des captures en jeu du modpack OVCR.