Add Sweetlogger

addons/sweet-logger/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sweetpea
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

addons/sweet-logger/README.md

@@ -0,0 +1,105 @@
+## hey - sweet logger you got there!
+---
+
+A Godot 4 addon that makes reading logs and debugging sane when you run multiple game instances at once.
+
+It's meant as a drop-in/stand-in for `print()`: same habit of sprinkling logs through your systems, but every line carries more context - which peer printed it, what kind of log it is, which script and function it came from. That makes it much easier to follow what each client (and the server) is doing when several instances share one console.
+
+When you're testing multiplayer locally (host + clients in separate run instances), the editor console fills with interleaved output from every peer. Sweet Logger formats each line the same way so you can tell at a glance **what kind of log it is**, **which peer it came from**, **when it happened**, and **which script/function** produced it.
+
+---
+
+## Features
+
+- **Peer-aware labels** - tags each line as `SERVER`, a client peer ID, or `DISCONNECTED`
+- **Color-coded peers** - consistent colors per peer so interleaved console output is easy to scan
+- **Log levels** - `log`, `info`, `warning`, `error`, `debug` with distinct colors
+- **Script context** - optional script and function name columns
+- **Local timestamps** - `mm:ss:ms` by default (optional hours)
+- **Rich console output** - uses `print_rich` with aligned columns
+
+---
+
+## Installation
+
+### From the Godot Asset Library
+
+1. In Godot, open the **AssetLib** tab.
+2. Search for **Sweet Logger** and download it.
+3. Open **Project → Project Settings → Plugins** and enable **Sweet Logger**.
+4. The plugin registers a `SweetLogger` autoload automatically.
+
+### Manual
+
+1. Copy the `addons/sweet-logger` folder into your project's `addons/` directory.
+2. In Godot, open **Project → Project Settings → Plugins** and enable **Sweet Logger**.
+3. The plugin registers a `SweetLogger` autoload automatically.
+
+---
+
+## Usage
+
+Call the autoload from anywhere:
+
+```gdscript
+SweetLogger.info("Player joined", [], "lobby.gd", "on_peer_connected")
+SweetLogger.warning("High latency: {0}ms", [rtt], "net.gd", "_process")
+SweetLogger.error("RPC failed", [], "sync.gd", "apply_state")
+SweetLogger.debug("Tick {0}", [tick], "game.gd", "_physics_process")
+SweetLogger.log("Hello from peer")
+```
+
+### Message formatting
+
+Pass optional args and use `{0}`, `{1}`, … placeholders:
+
+```gdscript
+SweetLogger.info("Spawned {0} at {1}", [entity_name, position], "spawner.gd", "spawn")
+```
+
+### API
+
+| Method                                                                | Level   |
+| --------------------------------------------------------------------- | ------- |
+| `SweetLogger.log(message, args=[], script_name="", function_name="")` | General |
+| `SweetLogger.info(...)`                                               | Info    |
+| `SweetLogger.warning(...)`                                            | Warning |
+| `SweetLogger.error(...)`                                              | Error   |
+| `SweetLogger.debug(...)`                                              | Debug   |
+
+
+All methods share the same signature: message, optional format args, optional script name, optional function name.
+
+## Configuration
+
+On the `SweetLogger` autoload (or in the inspector when selected):
+
+
+| Export                 | Default | Description                             |
+| ---------------------- | ------- | --------------------------------------- |
+| `SHOW_SCRIPT_NAME`     | `true`  | Include the script name column          |
+| `SHOW_FUNCTION_NAME`   | `true`  | Include the function name column        |
+| `SHOW_TIMESTAMP_HOURS` | `false` | Use `hh:mm:ss:ms` instead of `mm:ss:ms` |
+
+## Log line layout
+
+Each line is roughly:
+
+```
+[LEVEL][timestamp][PEER][script::function] message
+```
+
+- **LEVEL** - color by type (info blue, warning yellow, error red, etc.)
+- **timestamp** - local time for correlating events across instances
+- **PEER** - `SERVER`, numeric client ID, or `DISCONNECTED`, each with a stable color
+- **script::function** - where the log was emitted (when you pass those args)
+
+---
+
+## Why this exists
+
+Godot's "Run Multiple Instances" is great for testing multiplayer games on one machine, but plain `print()` output from every peer lands in one console with no clear ownership. Sweet Logger keeps a fixed column layout and peer coloring so you can follow one client's story (or the server's) without losing the others.
+
+## License
+
+MIT - see [LICENSE](addons/sweet-logger/LICENSE).

addons/sweet-logger/plugin.cfg

@@ -0,0 +1,7 @@
+[plugin]
+
+name="Sweet Logger"
+description="Rich console logging with peer-aware prefixes. Registers the SweetLogger autoload."
+author="sweetpea"
+version="1.0.0"
+script="plugin.gd"

addons/sweet-logger/plugin.gd

@@ -0,0 +1,13 @@
+@tool
+extends EditorPlugin
+
+const AUTOLOAD_NAME := "SweetLogger"
+const AUTOLOAD_PATH := "res://addons/sweet-logger/sweet_logger.gd"
+
+func _enter_tree() -> void:
+	var key := "autoload/%s" % AUTOLOAD_NAME
+	if not ProjectSettings.has_setting(key):
+		add_autoload_singleton(AUTOLOAD_NAME, AUTOLOAD_PATH)
+
+func _exit_tree() -> void:
+	remove_autoload_singleton(AUTOLOAD_NAME)

addons/sweet-logger/plugin.gd.uid

@@ -0,0 +1 @@
+uid://cm16x8s6cox4w

addons/sweet-logger/sweet_logger.gd

@@ -0,0 +1,289 @@
+extends Node
+
+## Global Logger singleton for consistent logging across the game.
+## All logs are prefixed with [peer_id]: to identify which instance is logging.
+## Uses print_rich with colorized backgrounds for log type, local time, peer IDs, and script context.
+
+# COLORS
+#===================================================================================#
+## Log type configuration with background color, message background color, and contrast text color
+const LOG_TYPES = {
+	"log": {
+		"bg_color": "#2d2d2d",
+		"message_bg_color": "#3d3d3d",
+		"text_color": "#ffffff"
+	},
+	"info": {
+		"bg_color": "#2563eb",
+		"message_bg_color": "#3b82f6",
+		"text_color": "#ffffff"
+	},
+	"warning": {
+		"bg_color": "#fbbf24",
+		"message_bg_color": "#fcd34d",
+		"text_color": "#ffffff"
+	},
+	"error": {
+		"bg_color": "#dc2626",
+		"message_bg_color": "#ef4444",
+		"text_color": "#ffffff"
+	},
+	"debug": {
+		"bg_color": "#7c3aed",
+		"message_bg_color": "#a78bfa",
+		"text_color": "#ffffff"
+	}
+}
+
+## Contrast text color that works on all backgrounds
+const CONTRAST_TEXT = "#ffffff"
+
+## Predefined colors for special peer IDs
+const SPECIAL_PEER_COLORS = {
+	"SERVER": {
+		"bg_color": "#7c3aed",
+		"text_color": "#ffffff"
+	},
+	"DISCONNECTED": {
+		"bg_color": "#6b7280",
+		"text_color": "#ffffff"
+	}
+}
+
+const PEER_COLOR_PALETTE = [
+	{"bg_color": "#10b981", "text_color": "#ffffff"},  # emerald green
+	{"bg_color": "#06b6d4", "text_color": "#ffffff"},  # cyan
+	{"bg_color": "#ec4899", "text_color": "#ffffff"},  # fuchsia pink
+	{"bg_color": "#f97316", "text_color": "#ffffff"},  # orange
+	{"bg_color": "#14b8a6", "text_color": "#ffffff"},  # teal
+	{"bg_color": "#84cc16", "text_color": "#000000"},  # lime green
+	{"bg_color": "#0ea5e9", "text_color": "#ffffff"},  # sky blue
+	{"bg_color": "#22c55e", "text_color": "#ffffff"},  # green
+	{"bg_color": "#e11d48", "text_color": "#ffffff"},  # rose red
+	{"bg_color": "#d946ef", "text_color": "#ffffff"},  # magenta
+]
+
+## Background color for the entire log line
+const LOG_LINE_BG_COLOR = "#1a1a1a"
+
+## Background color for the script/function name column
+const SCRIPT_FUNCTION_BG_COLOR = "#4a5a6a"
+
+## Background color for the local time column (between log type and peer id)
+const TIMESTAMP_BG_COLOR = "#1e3a5f"
+#===================================================================================#
+
+# WIDTHS
+#===================================================================================#
+## Column widths for alignment (in characters)
+const PEER_ID_COLUMN_WIDTH = 10
+const LOG_TYPE_COLUMN_WIDTH = 8
+## Default mm:ss:ms; with SHOW_TIMESTAMP_HOURS, hh:mm:ss:ms
+const TIMESTAMP_COLUMN_WIDTH_MMSSMS = 9
+const TIMESTAMP_COLUMN_WIDTH_HHMMSSMS = 12
+const SCRIPT_FUNCTION_COLUMN_WIDTH = 40
+#===================================================================================#
+
+# CONFIGURATION
+#===================================================================================#
+## Cache for peer ID colors to ensure consistency
+var _peer_color_cache: Dictionary = {}
+
+## Enable/disable showing script name and function name in logs
+@export var SHOW_SCRIPT_NAME = true
+@export var SHOW_FUNCTION_NAME = true
+## When false (default), timestamp is local mm:ss:ms. When true, local hh:mm:ss:ms (wider column).
+@export var SHOW_TIMESTAMP_HOURS = false
+#===================================================================================#
+
+# GETTERS
+#===================================================================================#
+func _get_peer_id() -> String:
+	"""Get the current peer ID, or return a default identifier if not connected."""
+	if multiplayer == null:
+		return "DISCONNECTED"
+
+	# Check if we're the server (server always has ID 1, but we check is_server() for clarity)
+	if multiplayer.is_server():
+		return "SERVER"
+
+	# Get the unique ID (will be 1 for server, or random positive int > 1 for clients)
+	var peer_id = multiplayer.get_unique_id()
+	return str(peer_id)
+
+func _get_peer_color_config(peer_id_str: String) -> Dictionary:
+	"""Get color configuration for a peer ID string."""
+	# Check special peer IDs first
+	if SPECIAL_PEER_COLORS.has(peer_id_str):
+		return SPECIAL_PEER_COLORS[peer_id_str]
+
+	# Check cache
+	if _peer_color_cache.has(peer_id_str):
+		return _peer_color_cache[peer_id_str]
+
+	# Generate consistent color based on peer ID
+	# Try to parse the peer_id_str as a number
+	var peer_id_num = peer_id_str.to_int()
+	var color_index: int
+	if peer_id_num > 0:
+		color_index = peer_id_num % PEER_COLOR_PALETTE.size()
+	else:
+		# If parsing fails, use hash of the string for consistency
+		var hash_value = peer_id_str.hash()
+		color_index = abs(hash_value) % PEER_COLOR_PALETTE.size()
+
+	var color_config = PEER_COLOR_PALETTE[color_index].duplicate()
+	_peer_color_cache[peer_id_str] = color_config
+	return color_config
+
+#===================================================================================#
+
+# FORMATTERS
+#===================================================================================#
+func _format_message(message: String, args: Array = []) -> String:
+	"""Format message with optional arguments."""
+	if args.is_empty():
+		return message
+
+	var formatted = message
+	for i in range(args.size()):
+		formatted = formatted.replace("{" + str(i) + "}", str(args[i]))
+
+	return formatted
+
+func _format_rich_text(text: String, bg_color: String, text_color: String) -> String:
+	"""Format text with background and text colors using BBCode."""
+	return "[bgcolor=%s][color=%s]%s[/color][/bgcolor]" % [bg_color, text_color, text]
+
+func _format_space_with_bg(bg_color: String) -> String:
+	"""Format a space character with a background color."""
+	return "[bgcolor=%s] [/bgcolor]" % bg_color
+
+func _get_padding(text_length: int, width: int) -> String:
+	"""Get padding string for a given text length and target width."""
+	if text_length >= width:
+		return ""
+	var padding = ""
+	for i in range(width - text_length):
+		padding += " "
+	return padding
+
+func _pad_text(text: String, width: int) -> String:
+	"""Pad text to a specific width for column alignment."""
+	return text + _get_padding(text.length(), width)
+
+func _truncate_text(text: String, max_length: int) -> String:
+	"""Truncate text to a maximum length."""
+	if text.length() <= max_length:
+		return text
+	return text.substr(0, max_length)
+
+func _get_local_timestamp_string() -> String:
+	"""Local time: mm:ss:ms by default, or hh:mm:ss:ms when SHOW_TIMESTAMP_HOURS is true."""
+	var unix = Time.get_unix_time_from_system()
+	var ms = clampi(int(floor(fmod(unix, 1.0) * 1000.0)), 0, 999)
+	var t = Time.get_time_dict_from_system()
+	if SHOW_TIMESTAMP_HOURS:
+		return "%02d:%02d:%02d:%03d" % [t.hour, t.minute, t.second, ms]
+	return "%02d:%02d:%03d" % [t.minute, t.second, ms]
+
+#===================================================================================#
+
+# PRINT
+#===================================================================================#
+func _print_rich_log(peer_id_str: String, log_type: String, message: String, script_name: String = "", function_name: String = "") -> void:
+	"""Print a rich formatted log with peer ID and log type colors."""
+	var peer_color = _get_peer_color_config(peer_id_str)
+	var log_config = LOG_TYPES.get(log_type, LOG_TYPES["log"])
+
+	# Use peer ID directly without "Peer" prefix
+	var peer_label = peer_id_str
+	var log_type_label = log_type.to_upper()
+
+	# Pad peer ID column for alignment
+	var peer_padded = _pad_text(peer_label, PEER_ID_COLUMN_WIDTH)
+
+	# Format peer ID with its background color
+	var peer_formatted = _format_rich_text(peer_padded, peer_color.bg_color, peer_color.text_color)
+
+	# Format log type with its background color
+	var log_type_padded = _pad_text(log_type_label, LOG_TYPE_COLUMN_WIDTH)
+	var log_type_formatted = _format_rich_text(log_type_padded, log_config.bg_color, log_config.text_color)
+
+	# Local time column (between log type and peer id)
+	var ts_width = TIMESTAMP_COLUMN_WIDTH_HHMMSSMS if SHOW_TIMESTAMP_HOURS else TIMESTAMP_COLUMN_WIDTH_MMSSMS
+	var time_padded = _pad_text(_get_local_timestamp_string(), ts_width)
+	var time_formatted = _format_rich_text(time_padded, TIMESTAMP_BG_COLOR, CONTRAST_TEXT)
+
+	# Build the context string (script name and function name) combined in one column
+	var context_string = ""
+	var script_function_parts: Array[String] = []
+
+	if SHOW_SCRIPT_NAME and script_name != "":
+		var script_truncated = _truncate_text(script_name, 18)
+		script_function_parts.append(script_truncated)
+
+	if SHOW_FUNCTION_NAME and function_name != "":
+		var function_truncated = _truncate_text(function_name, 20)
+		script_function_parts.append(function_truncated)
+
+	if not script_function_parts.is_empty():
+		# Combine script and function names with a separator
+		var combined = "::".join(script_function_parts)
+		# Pad, then format with custom background color (so whitespace has background too)
+		var combined_padded = _pad_text(combined, SCRIPT_FUNCTION_COLUMN_WIDTH)
+		var combined_formatted = _format_rich_text(combined_padded, SCRIPT_FUNCTION_BG_COLOR, log_config.text_color)
+		context_string = combined_formatted
+
+	# Format message with text color only (no background)
+	var message_formatted = "[color=%s]%s[/color]" % [log_config.text_color, message]
+
+	# Format spaces with peer ID background color
+	var peer_space = _format_space_with_bg(peer_color.bg_color)
+
+	# Combine log type, context, and message with peer-colored spaces
+	var peer_and_message = peer_formatted
+	if context_string != "":
+		peer_and_message += peer_space + context_string
+	peer_and_message += peer_space + message_formatted
+
+	# Create the full log line: log type, timestamp, then peer id and message
+	var log_line = log_type_formatted + time_formatted + peer_and_message
+	var wrapped_line = "[bgcolor=%s]%s[/bgcolor]" % [LOG_LINE_BG_COLOR, log_line]
+
+	print_rich(wrapped_line)
+
+#===================================================================================#
+
+# CALLERS
+#===================================================================================#
+func log(message: String, args: Array = [], script_name: String = "", function_name: String = "") -> void:
+	"""Basic log function with peer_id prefix."""
+	var formatted = _format_message(message, args)
+	var peer_id_str = _get_peer_id()
+	_print_rich_log(peer_id_str, "log", formatted, script_name, function_name)
+
+func info(message: String, args: Array = [], script_name: String = "", function_name: String = "") -> void:
+	"""Log an informational message."""
+	var formatted = _format_message(message, args)
+	var peer_id_str = _get_peer_id()
+	_print_rich_log(peer_id_str, "info", formatted, script_name, function_name)
+
+func warning(message: String, args: Array = [], script_name: String = "", function_name: String = "") -> void:
+	"""Log a warning message."""
+	var formatted = _format_message(message, args)
+	var peer_id_str = _get_peer_id()
+	_print_rich_log(peer_id_str, "warning", formatted, script_name, function_name)
+
+func error(message: String, args: Array = [], script_name: String = "", function_name: String = "") -> void:
+	"""Log an error message."""
+	var formatted = _format_message(message, args)
+	var peer_id_str = _get_peer_id()
+	_print_rich_log(peer_id_str, "error", formatted, script_name, function_name)
+
+func debug(message: String, args: Array = [], script_name: String = "", function_name: String = "") -> void:
+	"""Log a debug message."""
+	var formatted = _format_message(message, args)
+	var peer_id_str = _get_peer_id()
+	_print_rich_log(peer_id_str, "debug", formatted, script_name, function_name)
+#===================================================================================#

addons/sweet-logger/sweet_logger.gd.uid

@@ -0,0 +1 @@
+uid://cdfw054e8nhxv