feat(templates): full template management (create, upload, download, rename, mkdir, deploy, delete)

README.md

@@ -79,6 +79,29 @@ Fill in `NEXT_PUBLIC_CLOUDNET_ADDRESS` in your .env file, like for example: `NEX
 
 If you want to use a domain: `NEXT_PUBLIC_CLOUDNET_ADDRESS=https://cloudnet.example.com`.
 
+## Panel workflows
+
+See [`docs/PANEL_FEATURES.md`](docs/PANEL_FEATURES.md) for how the panel's
+task / group / template / service editors compose, when a change is picked
+up by a running server vs. only by future ones, and an end-to-end
+walkthrough of a minigame network using slime worlds.
+
+## Runtime service files (opt-in)
+
+The panel can expose a **Files** tab on each service that reads and writes
+the files of the running service in real time. This only makes sense when
+the panel is deployed **on the same host** as the CloudNet node, and it is
+disabled by default. To enable:
+
+1. In `docker-compose.yml` (or a `docker-compose.override.yml`) uncomment
+   the `volumes:` block that bind-mounts the node's `temp/services`
+   directory into `/services` inside the container.
+2. Set `CLOUDNET_SERVICES_PATH=/services` in your `.env`.
+3. Rebuild the container.
+
+The Files tab appears automatically when the endpoint reports it enabled
+and the user has `cloudnet_rest:service_write` (or `global:admin`).
+
 ## Bugs may occur
 
 Meaning if you encounter any issues, please open up an issue. You are welcome to contribute to this project and create a PR.

docker-compose.yml

@@ -35,6 +35,16 @@ services:
       - SENTRY_PROJECT=${SENTRY_PROJECT}
       - SENTRY_AUTH_TOKEN=${SENTRY_AUTH_TOKEN}
       - SENTRY_URL=${SENTRY_URL}
+      # Runtime service files browser (feature-flagged). When set, the panel
+      # exposes a Files tab on each service that reads/writes the files of
+      # the running service directly on the filesystem. Requires panel and
+      # CloudNet node to share the same host (bind-mount the node's
+      # temp/services directory into the container at this path).
+      - CLOUDNET_SERVICES_PATH=${CLOUDNET_SERVICES_PATH:-}
+    # volumes:
+    #   # Uncomment when running the panel on the same host as the CloudNet
+    #   # node. Target path must match CLOUDNET_SERVICES_PATH in .env.
+    #   - /opt/netcloud/node/temp/services:/services:rw
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "curl", "-f", "http://localhost:3000/api/health", "||", "exit", "1"]

docs/PANEL_FEATURES.md

@@ -0,0 +1,129 @@
+# Panel features — how they compose
+
+This PR adds workflows on top of what CloudNet already exposes over REST.
+It does **not** change how CloudNet itself works — the same rules about
+ephemeral vs. static services still apply, and they matter more than the
+features themselves. This doc explains what each button does, when the
+change actually reaches the server, and walks through a realistic
+minigame + Advanced Slime World Manager (ASWM) setup end to end.
+
+## The one rule that governs everything
+
+CloudNet has two service modes, set on the **task**:
+
+| Mode | Task fields | Behaviour |
+|---|---|---|
+| **Ephemeral** (default) | `autoDeleteOnStop: true`, `staticServices: false` | Runtime directory is destroyed on stop. Next start recreates the service **from the template**. |
+| **Static** | `autoDeleteOnStop: false`, `staticServices: true` | Runtime directory persists. Template is applied **only on first creation**. Subsequent starts do **not** re-apply the template. |
+
+**Minigame servers are almost always ephemeral** — you want a clean map at the start of every match. **Lobby, Survival, Skyblock are static** — you want configs and worlds to survive restarts.
+
+The whole point of the features below is to make it easy to put things in the right place for each mode.
+
+## Feature-by-feature: does the running server actually pick it up?
+
+| Feature | Ephemeral service | Static service |
+|---|---|---|
+| **Blueprint wizard** (Tasks → New task) | Creates the task and template — used for every future instance. | Same. |
+| **Templates → Xxx/default → edit file** | Applied to every new instance (each match starts fresh from template). | Applied only on **first** creation; running static services already ran past that. |
+| **Task form editor** (Form / JSON tabs) | New instances see the change on their next spawn. | Existing static services keep their old config; stop + start to rebuild from the updated task. |
+| **Group form editor** | Same as task. | Same as task. |
+| **Files tab** (runtime file browser) | Change is visible immediately to the running server. **Lost when the match ends** — the runtime directory is destroyed. | Persists across restarts because the runtime directory is kept. |
+| **Actions → Attach template / Flush** | Copies template files into the running service now. **Lost when the match ends.** | Kept. |
+| **Actions → Add inclusion / Download now** | Downloads the URL into the runtime now. **Lost when the match ends.** | Kept. |
+| **Actions → Send command** | Runs the command in the console. Anything the plugin persists to disk shares the same rules. | Same. |
+| **Actions → Save as template** (in Files tab) | Snapshots the runtime into a **template** — future matches start from this new state. | Same — a static service can also be snapshotted this way. |
+| **Actions → Wipe files** | Effectively a no-op for ephemeral (the runtime resets on next start anyway). | Nuclear — deletes the persistent runtime. |
+
+**One takeaway**: for an ephemeral service, anything you want to keep across matches must end up in the template. The panel gives you four ways to get it there:
+
+1. `Blueprint wizard` with the **bootstrap** checkbox at creation
+2. `Templates → local → Xxx/default` — direct edit for text configs / drag & drop jars
+3. `Files tab → Save as template` — after live-testing, snapshot the runtime into the template
+4. `Actions → Add deployment target` + `Deploy resources now` — same as #3, in two clicks
+
+## End-to-end walkthrough: minigame network with slime worlds
+
+Assume you want a Bedwars-style minigame using **ASWM** (Advanced Slime World Manager) so every match loads a slime world from MySQL (fast, no world folder on disk). Each game server is ephemeral: one match, then throw away.
+
+### 1. Create the task
+
+`Tasks → New task`
+
+- Preset: **Minigame / Event**
+- Server software: `paper` or `purpur`, MC version of your choice
+- Persistence: **Ephemeral** (default for this preset)
+- Task name: `Bedwars`, memory 2048 MB, min instances 2, start port `45500`
+- **Check "Pre-generate config files"** — CloudNet spins up a seed service so Paper writes out `bukkit.yml`, `spigot.yml`, `paper-global.yml`, `config/…`, then saves them into the template. Adds ~25s.
+
+Result: task `Bedwars`, template `local/Bedwars/default` with the jar and all default configs.
+
+### 2. Drop the plugins into the template
+
+`Templates → local → Bedwars → default → plugins/`
+
+Drag & drop:
+- `AdvancedSlimeWorldManager.jar`
+- Your minigame plugin `MyBedwars.jar`
+- Any dependencies (LuckPerms, ProtocolLib, …)
+
+The panel uploads them straight into the template folder.
+
+### 3. Configure ASWM
+
+First give ASWM a chance to write its default config. Two options:
+
+- **Preferred**: `Services → New service` → pick `Bedwars` and start one — it comes up, ASWM writes `plugins/AdvancedSlimeWorldManager/config.yml`, then stop the service, go to the service's **Files** tab, click **Save as template** with `Bedwars/default`. Now the template has the ASWM default config. Delete the throwaway service.
+- **Faster**: create the config file manually in the template with the values you want.
+
+Then `Templates → local → Bedwars → default → plugins → AdvancedSlimeWorldManager → config.yml`, open it, set your MySQL / MongoDB data source, list the slime worlds ASWM should load, save.
+
+### 4. Configure your minigame plugin the same way
+
+`Templates → local → Bedwars → default → plugins → MyBedwars → config.yml` — set arena names to match the slime world names ASWM will load.
+
+### 5. Start playing
+
+`Services → New service → Bedwars` — 2 instances spawn (the `minServiceCount` from the task), each loads its slime world from the DB, one match runs, everyone leaves, service auto-deletes, next match starts fresh from the same template. **This is the whole point of ephemeral + template + slime worlds together**: no world files to clean up, no per-match config drift, every match starts identical.
+
+### 6. Iterate
+
+You want to change a plugin config for the next match:
+
+- **Persistent change** (all future matches): edit the file in `Templates → local → Bedwars → default → plugins → …/config.yml`. Next match spawned starts with the new config.
+- **Hot patch during a match** (live but disposable): edit the same file in the running service's **Files** tab, then `Actions → Send command` → `/mybedwars reload`. The change lasts for this match only.
+- **You did a hot patch and it's good, keep it**: on the running service's **Files** tab click **Save as template** → `Bedwars/default`. Next match uses the new state.
+
+### 7. Add a new arena
+
+- Slime worlds are stored in your DB. Add the new slime with ASWM's own tools (or upload the .slime file if you keep them on disk).
+- Update `plugins/AdvancedSlimeWorldManager/config.yml` in the template to list the new world.
+- Update `plugins/MyBedwars/config.yml` in the template to declare the new arena.
+- Next match sees the new arena.
+
+### 8. Upgrade a plugin across the network
+
+- Drop the new jar into `Templates → local → Bedwars → default → plugins/` (overwrites the old one).
+- New matches use the new jar. Currently-running matches keep the old one until they end.
+- To force everyone onto the new version now: on each running service, `Actions → Attach template / Flush` with `Bedwars/default` (copies the plugin into the running service; you'll still need `/reload confirm` or restart).
+
+## What NOT to do
+
+- **Don't** edit the runtime `Files` tab of an ephemeral service expecting the change to survive the match. Use the template instead.
+- **Don't** convert a minigame task to `Static` to keep runtime changes — you'll accumulate worlds, logs, plugin data per instance until the disk fills. If you want changes to stick, save them to the template.
+- **Don't** put a `.slime` file inside the template if you're storing worlds in a DB — ASWM will get confused. Choose one storage.
+- **Don't** rely on the `Wipe files` action for cleanup on ephemeral services — they clean themselves. `Wipe files` is a big red button that only makes sense on static services when you want to fully reset one.
+
+## Where each button hits CloudNet
+
+Everything goes through the existing REST API, no changes to the node:
+
+- Templates: `POST /template/{s}/{p}/{n}/create`, `POST /file/create`, `POST /deploy`, `POST /directory/create`, `GET /file/download`, `DELETE`
+- Tasks: `POST /task` (upsert), `DELETE /task/{name}`
+- Groups: `POST /group` (upsert), `DELETE /group/{name}`
+- Services: `POST /service/create/taskName`, `PATCH /service/{id}/lifecycle?target=`, `POST /service/{id}/add/template`, `POST /service/{id}/add/deployment`, `POST /service/{id}/add/inclusion`, `POST /service/{id}/deployResources`, `POST /service/{id}/command`, `DELETE /service/{id}/deleteFiles`
+- Runtime service files: filesystem access via `CLOUDNET_SERVICES_PATH` bind-mount (feature-flagged)
+
+## Tested on
+
+CloudNet 4.0.0-RC17, Purpur 26.2, Velocity 3.5.1, ASWM InfernalSuite `dev/26.2` branch.

src/app/[locale]/(dashboard)/dashboard/groups/[groupId]/page.client.tsx

@@ -9,6 +9,8 @@ import { Terminal } from 'lucide-react'
 import { toast } from 'sonner'
 import { groupApi } from '@/lib/client-api'
 import { useTranslations } from 'gt-next/client'
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs'
+import GroupFormEditor from '@/components/editors/groupFormEditor'
 
 export default function GroupClientPage({
   group,
@@ -85,17 +87,26 @@ export default function GroupClientPage({
 
       {groupConfigData && (
         <div className="w-full mt-8">
-          <Label htmlFor="json">JSON</Label>
-          <div className="mt-2">
-            <Textarea
-              name="json"
-              id="json"
-              className={'h-96'}
-              required
-              value={groupConfigData}
-              onChange={(event) => setGroupConfigData(event.target.value)}
-            />
-          </div>
+          <Tabs defaultValue="form">
+            <TabsList>
+              <TabsTrigger value="form">Form</TabsTrigger>
+              <TabsTrigger value="json">JSON</TabsTrigger>
+            </TabsList>
+            <TabsContent value="form" className="mt-4">
+              <GroupFormEditor group={group} groupName={group.name} />
+            </TabsContent>
+            <TabsContent value="json" className="mt-4">
+              <Label htmlFor="json">JSON</Label>
+              <Textarea
+                name="json"
+                id="json"
+                className={'h-96 font-mono text-xs mt-2'}
+                required
+                value={groupConfigData}
+                onChange={(event) => setGroupConfigData(event.target.value)}
+              />
+            </TabsContent>
+          </Tabs>
         </div>
       )}
     </>

src/app/[locale]/(dashboard)/dashboard/groups/page.tsx

@@ -12,7 +12,7 @@ import { Button } from '@/components/ui/button'
 import { getPermissions } from '@/utils/server-api/getPermissions'
 import NoAccess from '@/components/static/noAccess'
 import NoRecords from '@/components/static/noRecords'
-import CreateGroup from '@/components/modules/groups/createGroup'
+import CreateGroup from '@/components/blueprint/createGroupDialog'
 import Link from 'next/link'
 import { serverGroupApi } from '@/lib/server-api'
 import { getTranslations } from 'gt-next/server'
@@ -48,12 +48,21 @@ export default async function GroupsPage() {
   }
 
   if (!groups.groups) {
-    return <NoRecords />
+    return (
+      <PageLayout title={groupsT('title')}>
+        <div className="mb-4 flex justify-end">
+          <CreateGroup />
+        </div>
+        <NoRecords />
+      </PageLayout>
+    )
   }
 
   return (
     <PageLayout title={groupsT('title')}>
-      <CreateGroup />
+      <div className="mb-4 flex justify-end">
+        <CreateGroup />
+      </div>
       <Table className={'mt-4'}>
         <TableCaption>{groupsT('tableCaption')}</TableCaption>
         <TableHeader>

src/app/[locale]/(dashboard)/dashboard/services/[serviceId]/page.tsx

@@ -17,6 +17,9 @@ import { getPermissions } from '@/utils/server-api/getPermissions'
 import { serverServiceApi } from '@/lib/server-api'
 import DoesNotExist from '@/components/static/doesNotExist'
 import { getTranslations } from 'gt-next/server'
+import ServiceFileBrowser from '@/components/services/serviceFileBrowser'
+import { isEnabled as serviceFilesEnabled } from '@/lib/serviceFs'
+import ServiceActionsTab from '@/components/services/serviceActionsTab'
 
 export default async function UserPage(props) {
   const params = await props.params
@@ -129,6 +132,8 @@ export default async function UserPage(props) {
       service?.configuration.serviceId.nameSplitter +
       service?.configuration.serviceId.taskServiceId || serviceT('name')
 
+  const showFilesTab = serviceFilesEnabled() && hasEditPermissions
+
   return (
     <PageLayout title={name}>
       <Tabs defaultValue={'config'}>
@@ -141,6 +146,12 @@ export default async function UserPage(props) {
           ) && (
             <TabsTrigger value={'console'}>{serviceT('console')}</TabsTrigger>
           )}
+          {hasEditPermissions && (
+            <TabsTrigger value={'actions'}>Actions</TabsTrigger>
+          )}
+          {showFilesTab && (
+            <TabsTrigger value={'files'}>Files</TabsTrigger>
+          )}
         </TabsList>
         <TabsContent value={'config'}>
           <ServiceClientPage
@@ -234,6 +245,16 @@ export default async function UserPage(props) {
             />
           </TabsContent>
         )}
+        {hasEditPermissions && (
+          <TabsContent value={'actions'}>
+            <ServiceActionsTab serviceId={serviceId} serviceName={name} />
+          </TabsContent>
+        )}
+        {showFilesTab && (
+          <TabsContent value={'files'}>
+            <ServiceFileBrowser serviceId={serviceId} />
+          </TabsContent>
+        )}
       </Tabs>
     </PageLayout>
   )

src/app/[locale]/(dashboard)/dashboard/services/page.tsx

@@ -17,6 +17,7 @@ import AutoRefresh from '@/components/autoRefresh'
 import Link from 'next/link'
 import { serverServiceApi } from '@/lib/server-api'
 import { getTranslations } from 'gt-next/server'
+import CreateServiceDialog from '@/components/blueprint/createServiceDialog'
 
 export default async function ServicesPage() {
   const servicesT = await getTranslations('Services')
@@ -38,11 +39,21 @@ export default async function ServicesPage() {
   }
 
   if (!services.services) {
-    return <NoRecords />
+    return (
+      <PageLayout title={servicesT('title')}>
+        <div className="mb-4 flex justify-end">
+          <CreateServiceDialog />
+        </div>
+        <NoRecords />
+      </PageLayout>
+    )
   }
 
   return (
     <PageLayout title={servicesT('title')}>
+      <div className="mb-4 flex justify-end">
+        <CreateServiceDialog />
+      </div>
       <AutoRefresh>
         <Table>
           <TableCaption>{servicesT('tableCaption')}</TableCaption>

src/app/[locale]/(dashboard)/dashboard/tasks/[taskId]/page.client.tsx

@@ -20,6 +20,8 @@ import { Terminal } from 'lucide-react'
 import { toast } from 'sonner'
 import { taskApi } from '@/lib/client-api'
 import { useTranslations } from 'gt-next/client'
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs'
+import TaskFormEditor from '@/components/editors/taskFormEditor'
 
 function DeleteButton({ taskId }: { taskId: string }) {
   const router = useRouter()
@@ -122,16 +124,25 @@ export default function TaskClientPage({
       </Alert>
       {children}
       <div className="w-full mt-8">
-        <Label htmlFor="json">{taskT('json')}</Label>
-        <div className="mt-2">
-          <Textarea
-            name="json"
-            id="json"
-            className={'h-96'}
-            value={body}
-            onChange={(e) => setBody(e.target.value)}
-          />
-        </div>
+        <Tabs defaultValue="form">
+          <TabsList>
+            <TabsTrigger value="form">Form</TabsTrigger>
+            <TabsTrigger value="json">{taskT('json')}</TabsTrigger>
+          </TabsList>
+          <TabsContent value="form" className="mt-4">
+            <TaskFormEditor task={JSON.parse(taskConfigData)} taskName={taskName} />
+          </TabsContent>
+          <TabsContent value="json" className="mt-4">
+            <Label htmlFor="json">{taskT('json')}</Label>
+            <Textarea
+              name="json"
+              id="json"
+              className={'h-96 font-mono text-xs mt-2'}
+              value={body}
+              onChange={(e) => setBody(e.target.value)}
+            />
+          </TabsContent>
+        </Tabs>
       </div>
     </div>
   )