Expanding scripting object methods

# Description

Expands the scripting API surface for `ActorObject`, `RoomObject`, `ItemObject`, `PetObject`, and `ContainerObject` with a broad set of new methods covering character state, inventory, equipment, quests, skills, spells, cooldowns, combat state, room properties, and container inspection. Updates the admin scripting reference documentation to match, and corrects "See Also" links across all script type pages to point to the new `scripting-objects` reference instead of the old `scripting-functions` anchors.

## Changes

**`internal/scripting/actor_func.go`**
- Added `GetDescription` — returns the actor's current description text
- Added `GetGold` / `GetBank` — returns carried gold and banked gold
- Added `GetWornItems` / `GetWornItem(slot)` — returns all equipped items or the item in a specific slot
- Added `FindInBackpack(itemName)` / `FindOnBody(itemName)` — fuzzy-search actor inventory and equipped slots
- Added `IsQuestDone(questToken)` / `ClearQuestToken(questToken)` — check quest completion and reset quest progress
- Added `GetAllSkills` / `GetSpells` — return skill ranks and spellbook as maps
- Added `UnLearnSpell` / `DisableSpell` / `EnableSpell` — mutate the actor's spellbook
- Added `GetCooldown(tag)` / `TryCooldown(tag, period)` — read and atomically check-and-set cooldowns
- Added `GetSetting(name)` / `SetSetting(name, value)` — read and write persistent character settings
- Added `GetExperience` / `GetExtraLives` — read progression state
- Added `IsInCombat` / `IsDowned` — check combat and health state
- Added `GetDefense` / `GetGearValue` / `GetCarryCapacity` — read gear and carry stats
- Added `GetZoneVisitProgress(zoneName)` — returns visited/total/percent exploration for a zone (user actors only)
- Added `GetAdjectives` / `HasAdjective(adj)` — inspect actor adjective state
- Added `GetActionPoints` / `GetActionPointsMax` — read current and maximum action points
- Added `GetHealthAppearance` — returns a human-readable health description string

**`internal/scripting/room_func.go`**
- Added `GetTitle` / `SetTitle(title)` — read and write the room's title
- Added `GetDescription` / `SetDescription(desc)` — read and write the room's description
- Added `GetGold` / `AddGold(amount)` / `RemoveGold(amount)` — inspect and mutate floor gold
- Added `GetZone` — returns the room's zone name
- Added `IsPvp` / `IsBank` — check room flags
- Added `GetContainer(name)` — returns a `ContainerObject` for the named container, or null
- Added `SpawnTempContainer(name, duration, lockDifficulty, ...trapBuffIds)` — creates a temporary container
- Added `IsCalm` / `AreMobsAttacking(userId)` / `ArePlayersAttacking(userId)` — query room combat state
- Added `MobCount` / `PlayerCount` — returns occupant counts
- Added `GetVisibility` — returns the room's current light level (0=dark, 1=dim, 2=lit)
- Added `GetNouns` / `AddNoun(noun, desc)` / `RemoveNoun(noun)` — manage room interactive nouns
- Added `GetSigns` / `AddSign(text, userId, days)` — read and post room signs
- Added `HasRecentVisitors` — returns whether the room has had recent activity
- Added `ContainerObject.GetLockDifficulty` / `GetTrapBuffIds` / `GetDespawnRound` / `Exists` — inspect container lock and lifecycle state

**`internal/scripting/item_func.go`**
- Added `GetType` / `GetSubtype` — returns the item's type and subtype strings
- Added `GetValue` / `GetDescription` / `GetQuestToken` / `GetElement` — read item spec fields
- Added `GetBuffIds` / `GetWornBuffIds` — returns use and passive buff IDs
- Added `GetStatMods` — returns stat modifier map
- Added `GetDamageReduction` / `GetDamage` — read armor and weapon stats
- Added `GetBreakChance` / `GetKeyLockId` — read item fragility and key lock ID
- Added `IsCursed` / `HasUses` / `IsWearable` / `IsWeapon` — boolean item classification helpers

**`internal/scripting/pet_func.go`**
- Added `GetItems` — returns all items in the pet's inventory
- Added `FindItem(itemName)` — fuzzy-search pet inventory
- Added `StoreItem(item)` / `RemoveItem(item)` — add and remove items from pet inventory
- Added `GetBuffIds` — returns the passive buff IDs the pet grants its owner

**Admin documentation (`_datafiles/html/admin/`)**
- Added documentation entries for all new methods to `scripting-objects.html` under their respective object sections
- Updated `scripting.html` to include `ContainerObject` in the function reference description
- Updated "See Also" links in `scripting-buffs.html`, `scripting-items.html`, `scripting-mobs.html`, `scripting-pets.html`, `scripting-rooms.html`, and `scripting-spells.html` to point to `scripting-objects` anchors instead of the old `scripting-functions` anchors
- Added a `ContainerObject Reference` See Also link to `scripting-rooms.html`

Author: Volte6

_datafiles/html/admin/scripting-buffs.html

@@ -168,7 +168,7 @@ <h2>Event Hooks</h2>
         <div class="see-also">
             <h3>See Also</h3>
             <div class="see-also-links">
-                <a class="see-also-link" href="/admin/scripting-functions#actor">ActorObject Functions</a>
+                <a class="see-also-link" href="/admin/scripting-objects#actor">ActorObject Reference</a>
                 <a class="see-also-link" href="/admin/buffs">Buff Definitions</a>
                 <a class="see-also-link" href="/admin/scripting">Scripting Overview</a>
             </div>

_datafiles/html/admin/scripting-items.html

@@ -239,9 +239,9 @@ <h2>Event Hooks</h2>
         <div class="see-also">
             <h3>See Also</h3>
             <div class="see-also-links">
-                <a class="see-also-link" href="/admin/scripting-functions#item">ItemObject Functions</a>
-                <a class="see-also-link" href="/admin/scripting-functions#actor">ActorObject Functions</a>
-                <a class="see-also-link" href="/admin/scripting-functions#room">RoomObject Functions</a>
+                <a class="see-also-link" href="/admin/scripting-objects#item">ItemObject Reference</a>
+                <a class="see-also-link" href="/admin/scripting-objects#actor">ActorObject Reference</a>
+                <a class="see-also-link" href="/admin/scripting-objects#room">RoomObject Reference</a>
                 <a class="see-also-link" href="/admin/scripting">Scripting Overview</a>
             </div>
         </div>

_datafiles/html/admin/scripting-mobs.html

@@ -370,9 +370,9 @@ <h2>Event Hooks</h2>
         <div class="see-also">
             <h3>See Also</h3>
             <div class="see-also-links">
-                <a class="see-also-link" href="/admin/scripting-functions#actor">ActorObject Functions</a>
-                <a class="see-also-link" href="/admin/scripting-functions#room">RoomObject Functions</a>
-                <a class="see-also-link" href="/admin/scripting-functions#item">ItemObject Functions</a>
+                <a class="see-also-link" href="/admin/scripting-objects#actor">ActorObject Reference</a>
+                <a class="see-also-link" href="/admin/scripting-objects#room">RoomObject Reference</a>
+                <a class="see-also-link" href="/admin/scripting-objects#item">ItemObject Reference</a>
                 <a class="see-also-link" href="/admin/scripting-functions#messaging">Messaging Functions</a>
                 <a class="see-also-link" href="/admin/scripting">Scripting Overview</a>
             </div>

_datafiles/html/admin/scripting-objects.html

@@ -228,9 +228,9 @@ <h2>Event Hooks</h2>
         <div class="see-also">
             <h3>See Also</h3>
             <div class="see-also-links">
-                <a class="see-also-link" href="/admin/scripting-functions#pet">PetObject Functions</a>
-                <a class="see-also-link" href="/admin/scripting-functions#actor">ActorObject Functions</a>
-                <a class="see-also-link" href="/admin/scripting-functions#room">RoomObject Functions</a>
+                <a class="see-also-link" href="/admin/scripting-objects#pet">PetObject Reference</a>
+                <a class="see-also-link" href="/admin/scripting-objects#actor">ActorObject Reference</a>
+                <a class="see-also-link" href="/admin/scripting-objects#room">RoomObject Reference</a>
                 <a class="see-also-link" href="/admin/pets">Pet Definitions</a>
                 <a class="see-also-link" href="/admin/scripting">Scripting Overview</a>
             </div>

_datafiles/html/admin/scripting-pets.html

@@ -413,8 +413,9 @@ <h2>Event Hooks</h2>
         <div class="see-also">
             <h3>See Also</h3>
             <div class="see-also-links">
-                <a class="see-also-link" href="/admin/scripting-functions#actor">ActorObject Functions</a>
-                <a class="see-also-link" href="/admin/scripting-functions#room">RoomObject Functions</a>
+                <a class="see-also-link" href="/admin/scripting-objects#actor">ActorObject Reference</a>
+                <a class="see-also-link" href="/admin/scripting-objects#room">RoomObject Reference</a>
+                <a class="see-also-link" href="/admin/scripting-objects#container">ContainerObject Reference</a>
                 <a class="see-also-link" href="/admin/scripting-functions#messaging">Messaging Functions</a>
                 <a class="see-also-link" href="/admin/scripting">Scripting Overview</a>
             </div>

_datafiles/html/admin/scripting-rooms.html

@@ -193,7 +193,7 @@ <h2>Event Hooks</h2>
         <div class="see-also">
             <h3>See Also</h3>
             <div class="see-also-links">
-                <a class="see-also-link" href="/admin/scripting-functions#actor">ActorObject Functions</a>
+                <a class="see-also-link" href="/admin/scripting-objects#actor">ActorObject Reference</a>
                 <a class="see-also-link" href="/admin/spells">Spell Definitions</a>
                 <a class="see-also-link" href="/admin/scripting">Scripting Overview</a>
             </div>

_datafiles/html/admin/scripting-spells.html

@@ -268,7 +268,7 @@ <h2>Quick Links</h2>
                     <div class="feature-card-icon">📖</div>
                     <div class="feature-card-body">
                         <div class="feature-card-title">Function Reference</div>
-                        <div class="feature-card-desc">Complete API docs for ActorObject, RoomObject, ItemObject, PetObject, PartyObject, Utility, Messaging, and Panel functions.</div>
+                        <div class="feature-card-desc">Complete API docs for ActorObject, RoomObject, ItemObject, PetObject, PartyObject, ContainerObject, Utility, Messaging, and Panel functions.</div>
                     </div>
                 </a>
                 <a class="feature-card" href="/admin/scripting-api">

_datafiles/html/admin/scripting.html

@@ -8,12 +8,14 @@ import (
 	"github.com/GoMudEngine/GoMud/internal/combat"
 	"github.com/GoMudEngine/GoMud/internal/configs"
 	"github.com/GoMudEngine/GoMud/internal/events"
+	"github.com/GoMudEngine/GoMud/internal/items"
 	"github.com/GoMudEngine/GoMud/internal/mobs"
 	"github.com/GoMudEngine/GoMud/internal/races"
 	"github.com/GoMudEngine/GoMud/internal/rooms"
 	"github.com/GoMudEngine/GoMud/internal/skills"
 	"github.com/GoMudEngine/GoMud/internal/templates"
 	"github.com/GoMudEngine/GoMud/internal/users"
+	"github.com/GoMudEngine/GoMud/internal/util"
 	"github.com/dop251/goja"
 )
 
@@ -914,3 +916,186 @@ func ActorNames(actorList []*ScriptActor) string {
 
 	return sBuilder.String()
 }
+
+// ////////////////////////////////////////////////////////
+//
+// New ScriptActor methods
+//
+// ////////////////////////////////////////////////////////
+
+func (a ScriptActor) GetDescription() string {
+	return a.characterRecord.GetDescription()
+}
+
+func (a ScriptActor) GetGold() int {
+	return a.characterRecord.Gold
+}
+
+func (a ScriptActor) GetBank() int {
+	return a.characterRecord.Bank
+}
+
+func (a ScriptActor) GetWornItems() []ScriptItem {
+	itms := make([]ScriptItem, 0)
+	for _, itm := range a.characterRecord.GetAllWornItems() {
+		itms = append(itms, newScriptItem(itm))
+	}
+	return itms
+}
+
+func (a ScriptActor) GetWornItem(slot string) *ScriptItem {
+	itm := a.characterRecord.Equipment.Get(items.ItemType(slot))
+	if itm == nil || itm.ItemId <= 0 || itm.IsDisabled() {
+		return nil
+	}
+	si := newScriptItem(*itm)
+	return &si
+}
+
+func (a ScriptActor) FindInBackpack(itemName string) *ScriptItem {
+	itm, found := a.characterRecord.FindInBackpack(itemName)
+	if !found {
+		return nil
+	}
+	si := newScriptItem(itm)
+	return &si
+}
+
+func (a ScriptActor) FindOnBody(itemName string) *ScriptItem {
+	itm, found := a.characterRecord.FindOnBody(itemName)
+	if !found {
+		return nil
+	}
+	si := newScriptItem(itm)
+	return &si
+}
+
+func (a ScriptActor) IsQuestDone(questToken string) bool {
+	return a.characterRecord.IsQuestDone(questToken)
+}
+
+func (a ScriptActor) ClearQuestToken(questToken string) {
+	a.characterRecord.ClearQuestToken(questToken)
+}
+
+func (a ScriptActor) GetAllSkills() map[string]int {
+	return a.characterRecord.GetAllSkillRanks()
+}
+
+func (a ScriptActor) GetSpells() map[string]int {
+	return a.characterRecord.GetSpells()
+}
+
+func (a ScriptActor) UnLearnSpell(spellId string) bool {
+	return a.characterRecord.UnLearnSpell(spellId)
+}
+
+func (a ScriptActor) DisableSpell(spellId string) bool {
+	return a.characterRecord.DisableSpell(spellId)
+}
+
+func (a ScriptActor) EnableSpell(spellId string) bool {
+	return a.characterRecord.EnableSpell(spellId)
+}
+
+func (a ScriptActor) GetCooldown(tag string) int {
+	return a.characterRecord.GetCooldown(tag)
+}
+
+func (a ScriptActor) TryCooldown(tag string, period string) bool {
+	return a.characterRecord.TryCooldown(tag, period)
+}
+
+func (a ScriptActor) GetSetting(name string) string {
+	return a.characterRecord.GetSetting(name)
+}
+
+func (a ScriptActor) SetSetting(name string, value string) {
+	a.characterRecord.SetSetting(name, value)
+}
+
+func (a ScriptActor) GetExperience() int {
+	return a.characterRecord.Experience
+}
+
+func (a ScriptActor) GetExtraLives() int {
+	return a.characterRecord.ExtraLives
+}
+
+func (a ScriptActor) IsInCombat() bool {
+	return a.characterRecord.Aggro != nil
+}
+
+func (a ScriptActor) IsDowned() bool {
+	return a.characterRecord.Health < 1
+}
+
+func (a ScriptActor) GetDefense() int {
+	return a.characterRecord.GetDefense()
+}
+
+func (a ScriptActor) GetGearValue() int {
+	return a.characterRecord.GetGearValue()
+}
+
+func (a ScriptActor) GetCarryCapacity() int {
+	return a.characterRecord.CarryCapacity()
+}
+
+func (a ScriptActor) GetZoneVisitProgress(zoneName string) map[string]any {
+	resolvedZone := rooms.FindZoneName(zoneName)
+	if resolvedZone == `` {
+		return map[string]any{`visited`: 0, `total`: 0, `percent`: 0}
+	}
+	zCfg := rooms.GetZoneConfig(resolvedZone)
+	var validRoomIds map[int]struct{}
+	if zCfg != nil {
+		validRoomIds = zCfg.RoomIds
+	}
+	visited, total := a.characterRecord.ZoneVisitProgress(resolvedZone, validRoomIds)
+	percent := 0
+	if total > 0 {
+		percent = int(float64(visited) / float64(total) * 100)
+	}
+	return map[string]any{`visited`: visited, `total`: total, `percent`: percent}
+}
+
+func (a ScriptActor) GetAdjectives() []string {
+	return a.characterRecord.GetAdjectives()
+}
+
+func (a ScriptActor) HasAdjective(adj string) bool {
+	return a.characterRecord.HasAdjective(adj)
+}
+
+func (a ScriptActor) GetActionPoints() int {
+	return a.characterRecord.ActionPoints
+}
+
+func (a ScriptActor) GetActionPointsMax() int {
+	return a.characterRecord.ActionPointsMax.Value
+}
+
+func (a ScriptActor) GetHealthAppearance() string {
+	if a.characterRecord.HealthMax.Value < 1 {
+		return a.GetCharacterName(true) + ` is in perfect health.`
+	}
+	nameTag := `username`
+	if a.mobRecord != nil {
+		nameTag = `mobname`
+	}
+	pct := int(float64(a.characterRecord.Health) / float64(a.characterRecord.HealthMax.Value) * 100)
+	className := util.HealthClass(a.characterRecord.Health, a.characterRecord.HealthMax.Value)
+	name := `<ansi fg="` + nameTag + `">` + a.characterRecord.Name + `</ansi>`
+	switch {
+	case pct < 15:
+		return name + ` looks like they're <ansi fg="` + className + `">about to die!</ansi>`
+	case pct < 50:
+		return name + ` looks to be in <ansi fg="` + className + `">pretty bad shape.</ansi>`
+	case pct < 80:
+		return name + ` has some <ansi fg="` + className + `">cuts and bruises.</ansi>`
+	case pct < 100:
+		return name + ` has <ansi fg="` + className + `">a few scratches.</ansi>`
+	}
+	return name + ` is in <ansi fg="` + className + `">perfect health.</ansi>`
+}