Passer au contenu principal
Version: bleeding-edge 🩸

Mode de jeu Sandbox

Découvrez comment fonctionne le mode de jeu Sandbox et comment l'étendre et vous y intégrer par script.

Le mode de jeu Sandbox est le mode de jeu par défaut de nanos world : il offre aux joueurs une base pour explorer et expérimenter les fonctionnalités du moteur. C'est un mode de jeu libre où les joueurs peuvent faire apparaître des objets, des véhicules, des armes et bien plus pour interagir avec le monde.

Il est entièrement fait en script, on peut donc le personnaliser avec du Lua et du HTML/JS/CSS. Il expose aussi plusieurs méthodes pour y intégrer facilement vos packages et étendre ses fonctionnalités.

Concepts de base​

Le mode de jeu Sandbox exporte une variable globale Sandbox, accessible depuis n'importe quel package chargé, qui contient toutes ses méthodes et propriétés. Vous pouvez utiliser cette variable pour interagir avec le mode de jeu et étendre ses fonctionnalités depuis vos packages.

tip

Votre Package peut aussi être chargé sur des serveurs qui utilisent d'autres game-modes. Par précaution, vérifiez que le Sandbox est disponible avant de l'utiliser, et ajoutez sandbox aux compatible_game_modes de votre Package.toml pour que les joueurs sachent que votre Package est fait pour lui :

Client/Index.lua
Package.Subscribe("Load", function()
-- Only integrates with the Sandbox if it's loaded
if (not Sandbox) then return end

Sandbox.SpawnMenu.AddCategory("props", "my-category", "my category", "package://my-package/Client/icon.webp")
end)

Ses fonctionnalités sont réparties en plusieurs sous-systèmes, dont les principaux sont :

Menu d'apparition​

Un menu qui permet aux joueurs de faire apparaître des éléments dans le monde : Props, entités, véhicules, armes, etc. Il s'ouvre avec la touche Q par défaut et reste affiché tant qu'elle est enfoncée.

Menu d'apparitionexplore/sandbox-game-mode/spawn-menu

Menu contextuel​

Un menu de réglages en jeu, par exemple pour ajuster la lumière du soleil, réapparaître ou personnaliser l'outil actuel. Il s'ouvre avec la touche C par défaut, et chaque appui l'affiche ou le masque.

Menu contextuelexplore/sandbox-game-mode/context-menu

Tool Guns​

Un ensemble d'armes aux fonctions spéciales pour interagir avec le monde : déplacer des objets, ajouter des contraintes, faire apparaître des entités, etc. Elles s'obtiennent via le menu d'apparition.

Tool Gunsexplore/sandbox-game-mode/tool-guns

Autres sous-systèmes​

Il existe aussi d'autres sous-systèmes, comme les tutoriels et les notifications, détaillés sur la page Fonctionnalités supplémentaires :

Fonctionnalités supplémentairesexplore/sandbox-game-mode/extra-features