Rework navigating configuration pages.

docs/paper/admin/reference/configuration/README.md → docs/paper/admin/reference/configuration/README.mdx

@@ -4,6 +4,14 @@ slug: /reference/configuration
 
 # Paper Configuration
 
+import ConfigurationStructureDiagram from '@site/src/components/ConfigurationStructureDiagram';
+
+---
+
+## Paper Configuration Files
+
+<ConfigurationStructureDiagram/>
+
 ## Per World Configuration
 
 One of the most powerful yet least understood features of the Paper configuration is setting

src/components/ConfigurationStructureDiagram.tsx

@@ -0,0 +1,124 @@
+import React, {useState} from "react";
+import "@site/src/css/configuration-explorer-layout.css";
+
+interface ExplorerNode {
+    name: string;
+    type: "folder" | "file";
+    children?: ExplorerNode[];
+    description?: string;
+    url?: string;
+}
+
+const folderData: ExplorerNode[] = [
+    {
+        name: "config",
+        type: "folder",
+        children: [
+            { name: "paper-global.yml", type: "file", url: "/paper/reference/global-configuration" },
+            { name: "paper-world-defaults.yml", type: "file", url: "/paper/reference/world-configuration" },
+        ],
+    },
+    {
+        name: "plugins",
+        type: "folder",
+        description: "You can place your plugin jars here.",
+    },
+    {
+        name: "<world>",
+        type: "folder",
+        children: [
+            { name: "paper-world.yml", type: "file", url: "/paper/reference/configuration#per-world-values" },
+        ],
+    },
+    { name: "banned-ips.json", type: "file", description: "This file stores all the banned IP addresses on the server." },
+    { name: "banned-players.json", type: "file", description: "This file stores all the banned player information for the server." },
+    { name: "bukkit.yml", type: "file", url: "/paper/reference/bukkit-configuration" },
+    { name: "commands.yml", type: "file", url: "/paper/reference/bukkit-commands-configuration" },
+    { name: "eula.txt", type: "file", description: "This file is in place to allow you to accept the Minecraft EULA.\nThis is required to start the server." },
+    { name: "help.yml", type: "file", description: "This file provides you with a wide variety of ways to configure the /help system in your Paper Server." },
+    { name: "ops.json", type: "file", description: "ops.json is a JSON file located in the root directory of a server containing a list of players with operator status." },
+    { name: "permissions.yml", type: "file", description: "The permissions.yml file allows creating of permission nodes so that server admins can easily distribute permissions." },
+    { name: "server.properties", type: "file", url: "/paper/reference/server-properties" },
+    { name: "spigot.yml", type: "file", url: "/paper/reference/spigot-configuration" },
+    { name: "usercache.json", type: "file", description: "This file acts as a cache of user information that has been requested from Mojang's servers when they join the server or their texture is used as a Head." },
+    { name: "whitelist.json", type: "file", description: "This is is a server configuration file that stores the usernames of players who have been whitelisted on a server." },
+];
+
+interface IndentationArrowProps {
+    level: number;
+}
+
+const IndentationArrow: React.FC<IndentationArrowProps> = ({ level }) => {
+    if (level === 0) {
+        return null;
+    }
+
+    return (
+        <span className={"indentation-arrow"}>
+            {level > 0 && "→".repeat(level)}
+        </span>
+    );
+};
+
+export default function ConfigurationStructureDiagram() {
+    const [popupNode, setPopupNode] = useState<ExplorerNode | null>(null);
+
+    const renderNode = (node: ExplorerNode, level: number = 0) => {
+        const isFolder = node.type === "folder";
+        const hasDescription = "description" in node;
+        const hasUrl = "url" in node;
+
+        const handleNodeOpening = (event: React.MouseEvent) => {
+            event.stopPropagation();
+            setPopupNode(node);
+        };
+
+        return (
+            <div key={node.name} className={level > 0 ? "config-explorer-node" : "config-explorer-node-noflex"} onMouseLeave={() => {setPopupNode(null)}}>
+
+                {level > 0 &&
+                    <IndentationArrow level={level} />
+                }
+
+                <a className={`${("config-explorer-file-" + (isFolder ? "folder-" : "") + "node")} 
+                   ${(!hasUrl ? "config-explorer-file-node" : "config-explorer-file-node-with-link")}`} href={node.url}
+                   style={{cursor: hasUrl ? "pointer" : "default"}}>
+
+                    <span style={{cursor: hasDescription ? "pointer" : "auto"}} className={"config-explorer-node-icon"}>
+                        {isFolder ? "📁" : "📄"}
+                    </span>
+                    <span style={{ margin: "0 5px 0 5px" }}>
+                        {node.name}
+                    </span>
+                    {hasDescription && (
+                        <span className={"config-explorer-popup-window-open-tag"} onMouseEnter={handleNodeOpening}>ⓘ</span>
+                    )}
+                </a>
+
+                {hasDescription && (
+                    <div className={"config-explorer-popup-window-container"}>
+                        <div className={"config-explorer-popup-window"}
+                             style={{ display: popupNode === node ? "block" : "none" }}>
+                            <strong>Description:</strong><br/>{node.description}
+                        </div>
+                    </div>
+                )}
+
+                {isFolder && node.children &&
+                    node.children.map((child) => (
+                        <div key={child.name}>
+                            {renderNode(child, level + 1)}
+                        </div>
+                    ))}
+            </div>
+        );
+    };
+
+    return (
+        <div>
+            <pre className={"config-explorer-code-outer-container"}>
+                {folderData.map((item) => renderNode(item))}
+            </pre>
+        </div>
+    );
+}

src/css/configuration-explorer-layout.css

@@ -0,0 +1,95 @@
+/* Outer Container */
+.config-explorer-code-outer-container {
+  overflow: visible;
+  white-space: nowrap;
+}
+
+/* File Node */
+.config-explorer-file-node {
+  display: flex;
+  align-items: center;
+  border-radius: 10px;
+  width: fit-content;
+  flex-shrink: 0;
+  white-space: nowrap;
+}
+
+.config-explorer-file-node-with-link:hover {
+  background-color: rgba(0, 0, 0, 0.1);
+  cursor: pointer;
+  text-decoration: none;
+}
+
+/* File Folder Node */
+.config-explorer-file-folder-node {
+  display: flex;
+  align-items: center;
+  width: fit-content;
+  color: var(--config-node-highlight-text-color);
+}
+
+.config-explorer-file-folder-node:hover {
+  cursor: default;
+  text-decoration: none;
+  color: var(--config-node-highlight-text-color);
+}
+
+/* Popup Window Container */
+.config-explorer-popup-window-container {
+  position: absolute;
+  margin-left: 30px;
+  transform: translateZ(0);
+  top: 100%;
+  left: 0;
+  width: fit-content;
+  z-index: 10;
+  white-space: normal;
+}
+
+/* Popup Window */
+.config-explorer-popup-window {
+  background-color: #1c1e21;
+  padding: 10px;
+  box-shadow: 0 2px 5px rgba(0, 0, 0, 0.1);
+  border-radius: 5px;
+  margin-right: 100px;
+  width: fit-content;
+  z-index: 20;
+  white-space: pre-wrap;
+}
+
+.config-explorer-popup-window-open-tag {
+  z-index: 5;
+}
+
+.config-explorer-popup-window-open-tag:hover {
+  font-weight: bold;
+  cursor: pointer;
+}
+
+/* Indentation Arrow */
+.indentation-arrow {
+  font-size: 14px;
+  color: #bbbbbb;
+  margin: 0 8px 0 8px;
+}
+
+/* Node Icon */
+.config-explorer-node-icon {
+  font-size: 20px;
+}
+
+/* Node */
+.config-explorer-node {
+  align-items: center;
+  position: relative;
+  display: flex;
+  flex-shrink: 0;
+  white-space: nowrap;
+}
+
+/* Node without Flex */
+.config-explorer-node-noflex {
+  align-items: center;
+  position: relative;
+}

src/css/custom.css

@@ -13,6 +13,7 @@
   /* Config Node */
   --default-config-node-text-color: rgb(148, 148, 148);
   --config-node-highlight-text-color: black;
+  --config-explorer-file-node-text-color: rgba(0, 0, 0, 0.03);
 }
 
 html[data-theme="dark"] {
@@ -29,6 +30,7 @@ html[data-theme="dark"] {
   /* Config Node */
   --default-config-node-text-color: rgb(128, 128, 128);
   --config-node-highlight-text-color: white;
+  --config-explorer-file-node-text-color: rgba(0, 0, 0, 0.1);
 }
 
 .button.button--secondary {