Room Exit Messages

_datafiles/guides/building/scripting/FUNCTIONS_ACTORS.md

@@ -29,7 +29,8 @@ ActorObjects are the basic object that represents Users and NPCs
   - [ActorObject.AddGold(amt int \[, bankAmt int\])](#actorobjectaddgoldamt-int--bankamt-int)
   - [ActorObject.AddHealth(amt int) int](#actorobjectaddhealthamt-int-int)
   - [ActorObject.Sleep(seconds int)](#actorobjectsleepseconds-int)
-  - [ActorObject.Command(cmd string, waitTurns ...int)](#actorobjectcommandcmd-string-waitturns-int)
+  - [ActorObject.Command(cmd string \[, waitTurns int\])](#actorobjectcommandcmd-string--waitturns-int)
+  - [ActorObject.CommandFlagged(cmd string, flag int \[, waitTurns int\])](#actorobjectcommandflaggedcmd-string-flag-int--waitturns-int)
   - [ActorObject.IsTameable() bool](#actorobjectistameable-bool)
   - [ActorObject.TrainSkill(skillName string, skillLevel int)](#actorobjecttrainskillskillname-string-skilllevel-int)
   - [ActorObject.GetSkillLevel(skillName string)](#actorobjectgetskilllevelskillname-string)
@@ -259,7 +260,7 @@ _Note: Only works on mobs._
 | --- | --- |
 | seconds | How many seconds to wait. |
 
-## [ActorObject.Command(cmd string, waitTurns ...int)](/internal/scripting/actor_func.go)
+## [ActorObject.Command(cmd string [, waitTurns int])](/internal/scripting/actor_func.go)
 Forces an ActorObject to execute a command as if they entered it
 
 _Note: Don't underestimate the power of this function! Complex and interesting behaviors or interactions can emerge from using it._
@@ -269,6 +270,18 @@ _Note: Don't underestimate the power of this function! Complex and interesting b
 | cmd | The command to execute such as `look west` or `say goodbye`. |
 | waitTurns (optional) | The number of turns (NOT rounds) to wait before executing the command. |
 
+## [ActorObject.CommandFlagged(cmd string, flag int [, waitTurns int])](/internal/scripting/actor_func.go)
+Forces an ActorObject to execute a command as if they entered it.
+WARNING: Advanced Usage. Required a flag integer.
+
+_Note: Don't underestimate the power of this function! Complex and interesting behaviors or interactions can emerge from using it._
+
+|  Argument | Explanation |
+| --- | --- |
+| cmd | The command to execute such as `look west` or `say goodbye`. |
+| flag | The special control flag to pass to the command. |
+| waitTurns (optional) | The number of turns (NOT rounds) to wait before executing the command. |
+
 ## [ActorObject.IsTameable() bool](/internal/scripting/actor_func.go)
 Returns `true` if actor can be tamed.
 

_datafiles/world/default/users/admin.yaml

@@ -63,17 +63,17 @@ character:
     - buffid: 28
       onstartevent: true
       permabuff: true
-      roundcounter: 28
+      roundcounter: 23
       triggersleft: 1000000000
     - buffid: 29
       onstartevent: true
       permabuff: true
-      roundcounter: 36
+      roundcounter: 16
       triggersleft: 1000000000
     - buffid: 39
       onstartevent: false
       permabuff: true
-      roundcounter: 10
+      roundcounter: 5
       triggersleft: 1000000000
   equipment:
     weapon:

internal/events/eventtypes.go

@@ -35,6 +35,7 @@ type Input struct {
 	MobInstanceId int
 	InputText     string
 	WaitTurns     int
+	Flags         uint64
 }
 
 func (i Input) Type() string { return `Input` }

internal/exit/exit.go

@@ -16,6 +16,7 @@ type RoomExit struct {
 	RoomId       int
 	Secret       bool          `yaml:"secret,omitempty"`
 	MapDirection string        `yaml:"mapdirection,omitempty"` // Optionaly indicate the direction of this exit for mapping purposes
+	ExitMessage  string        `yaml:"exitmessage,omitempty"`  // If set, this message is sent to the user, followed by a delay, before they actually go through the exit.
 	Lock         gamelock.Lock `yaml:"lock,omitempty"`         // 0 - no lock. greater than zero = difficulty to unlock.
 }
 

internal/scripting/actor_func.go

@@ -309,6 +309,17 @@ func (a ScriptActor) Command(cmd string, waitTurns ...int) {
 	}
 }
 
+func (a ScriptActor) CommandFlagged(cmd string, flags int, waitTurns ...int) {
+	if len(waitTurns) < 1 {
+		waitTurns = append(waitTurns, 0)
+	}
+	if a.userId > 0 {
+		a.userRecord.CommandFlagged(cmd, uint64(flags), waitTurns[0])
+	} else {
+		a.mobRecord.Command(cmd, waitTurns[0])
+	}
+}
+
 func (a ScriptActor) TrainSkill(skillName string, skillLevel int) bool {
 
 	if a.userRecord == nil {

internal/usercommands/README.md

@@ -3,7 +3,7 @@
 The `usercommands` package defines a function type and contains all of the commands a user can enter.
 
 ```
-type UserCommand func(rest string, user *users.UserRecord, room *rooms.Room) (bool, error)
+type UserCommand func(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error)
 ```
 
 All commands follow that definition, where
@@ -13,7 +13,7 @@ All commands follow that definition, where
 
 ```
 
-func Glarble(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Glarble(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
     room.SendText(`This glarble text goes out to all players in room`)
 

internal/usercommands/admin.badcommands.go

@@ -9,7 +9,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func BadCommands(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func BadCommands(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if rest == "clear" {
 		badinputtracker.Clear()

internal/usercommands/admin.buff.go

@@ -16,7 +16,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Buff(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Buff(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	// args should look like one of the following:
 	// target buffId - put buff on target if in the room

internal/usercommands/admin.build.go

@@ -12,7 +12,7 @@ import (
 	"github.com/volte6/gomud/internal/util"
 )
 
-func IBuild(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func IBuild(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	// args should look like one of the following:
 	// info <optional room id>
@@ -115,7 +115,7 @@ func IBuild(rest string, user *users.UserRecord, room *rooms.Room) (bool, error)
 	return true, nil
 }
 
-func Build(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Build(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	// args should look like one of the following:
 	// info <optional room id>

internal/usercommands/admin.command.go

@@ -12,7 +12,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Command(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Command(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	// args should look like one of the following:
 	// target buffId - put buff on target if in the room

internal/usercommands/admin.deafen.go

@@ -9,7 +9,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Deafen(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Deafen(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if rest == "" {
 		infoOutput, _ := templates.Process("admincommands/help/command.deafen", nil)
@@ -36,7 +36,7 @@ func Deafen(rest string, user *users.UserRecord, room *rooms.Room) (bool, error)
 	return true, nil
 }
 
-func UnDeafen(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func UnDeafen(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if rest == "" {
 		infoOutput, _ := templates.Process("admincommands/help/command.deafen", nil)

internal/usercommands/admin.grant.go

@@ -12,7 +12,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Grant(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Grant(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if rest == "" {
 		infoOutput, _ := templates.Process("admincommands/help/command.grant", nil)

internal/usercommands/admin.item.go

@@ -16,7 +16,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Item(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Item(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if user.Permission != users.PermissionAdmin {
 		user.SendText(`<ansi fg="alert-4">Only admins can use this command</ansi>`)
@@ -33,23 +33,23 @@ func Item(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
 
 	// create a new item
 	if args[0] == `create` {
-		return item_Create(strings.TrimSpace(rest[6:]), user, room)
+		return item_Create(strings.TrimSpace(rest[6:]), user, room, flags)
 	}
 
 	// spawn an existing item
 	if args[0] == `spawn` {
-		return item_Spawn(strings.TrimSpace(rest[5:]), user, room)
+		return item_Spawn(strings.TrimSpace(rest[5:]), user, room, flags)
 	}
 
 	// List existing items
 	if args[0] == `list` {
-		return item_List(strings.TrimSpace(rest[4:]), user, room)
+		return item_List(strings.TrimSpace(rest[4:]), user, room, flags)
 	}
 
 	return true, nil
 }
 
-func item_List(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func item_List(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	itmNames := []templates.NameDescription{}
 
@@ -80,7 +80,7 @@ func item_List(rest string, user *users.UserRecord, room *rooms.Room) (bool, err
 	return true, nil
 }
 
-func item_Spawn(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func item_Spawn(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	itemId := items.FindItem(rest)
 	if itemId != 0 {
@@ -109,7 +109,7 @@ func item_Spawn(rest string, user *users.UserRecord, room *rooms.Room) (bool, er
 	return true, nil
 }
 
-func item_Create(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func item_Create(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	var newItemSpec = items.ItemSpec{}
 

internal/usercommands/admin.locate.go

@@ -12,7 +12,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Locate(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Locate(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if rest == "" {
 		infoOutput, _ := templates.Process("admincommands/help/command.locate", nil)

internal/usercommands/admin.mob.go

@@ -18,7 +18,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Mob(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Mob(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if user.Permission != users.PermissionAdmin {
 		user.SendText(`<ansi fg="alert-4">Only admins can use this command</ansi>`)
@@ -35,23 +35,23 @@ func Mob(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
 
 	// Create a new mob
 	if args[0] == `create` {
-		return mob_Create(strings.TrimSpace(rest[6:]), user, room)
+		return mob_Create(strings.TrimSpace(rest[6:]), user, room, flags)
 	}
 
 	// Spawn a mob instance
 	if args[0] == `spawn` {
-		return mob_Spawn(strings.TrimSpace(rest[5:]), user, room)
+		return mob_Spawn(strings.TrimSpace(rest[5:]), user, room, flags)
 	}
 
 	// List existing mobs
 	if args[0] == `list` {
-		return mob_List(strings.TrimSpace(rest[4:]), user, room)
+		return mob_List(strings.TrimSpace(rest[4:]), user, room, flags)
 	}
 
 	return true, nil
 }
 
-func mob_List(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func mob_List(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	mobNames := []templates.NameDescription{}
 
@@ -83,7 +83,7 @@ func mob_List(rest string, user *users.UserRecord, room *rooms.Room) (bool, erro
 	return true, nil
 }
 
-func mob_Spawn(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func mob_Spawn(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	c := configs.GetConfig()
 
@@ -127,7 +127,7 @@ func mob_Spawn(rest string, user *users.UserRecord, room *rooms.Room) (bool, err
 	return true, nil
 }
 
-func mob_Create(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func mob_Create(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	var newMob = mobs.Mob{}
 
@@ -220,7 +220,7 @@ func mob_Create(rest string, user *users.UserRecord, room *rooms.Room) (bool, er
 		}
 
 		question.RejectResponse()
-		return Help(helpCmd+` `+helpRest, user, room)
+		return Help(helpCmd+` `+helpRest, user, room, flags)
 	}
 
 	raceNameSelection := question.Response

internal/usercommands/admin.modify.go

@@ -11,7 +11,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Modify(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Modify(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if user.Permission != users.PermissionAdmin {
 		user.SendText(`<ansi fg="alert-4">Only admins can use this command</ansi>`)

internal/usercommands/admin.mudmail.go

@@ -11,7 +11,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Mudmail(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Mudmail(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	/*
 		args := util.SplitButRespectQuotes(rest)

internal/usercommands/admin.mute.go

@@ -9,7 +9,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Mute(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Mute(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if rest == "" {
 		infoOutput, _ := templates.Process("admincommands/help/command.mute", nil)
@@ -36,7 +36,7 @@ func Mute(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
 	return true, nil
 }
 
-func UnMute(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func UnMute(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if rest == "" {
 		infoOutput, _ := templates.Process("admincommands/help/command.mute", nil)

internal/usercommands/admin.paz.go

@@ -10,7 +10,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Paz(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Paz(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	beamOfLight := colorpatterns.ApplyColorPattern(`beam of light`, `rainbow`)
 

internal/usercommands/admin.prepare.go

@@ -6,7 +6,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Prepare(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Prepare(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if rest == "" {
 		infoOutput, _ := templates.Process("admincommands/help/command.prepare", nil)

internal/usercommands/admin.questtoken.go

@@ -11,7 +11,7 @@ import (
 	"github.com/volte6/gomud/internal/util"
 )
 
-func QuestToken(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func QuestToken(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	// args should look like one of the following:
 	// questtoken <tokenname>

internal/usercommands/admin.redescribe.go

@@ -10,7 +10,7 @@ import (
 	"github.com/volte6/gomud/internal/util"
 )
 
-func Redescribe(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Redescribe(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	args := util.SplitButRespectQuotes(rest)
 

internal/usercommands/admin.reload.go

@@ -9,7 +9,7 @@ import (
 	"github.com/volte6/gomud/internal/users"
 )
 
-func Reload(rest string, user *users.UserRecord, room *rooms.Room) (bool, error) {
+func Reload(rest string, user *users.UserRecord, room *rooms.Room, flags UserCommandFlag) (bool, error) {
 
 	if rest == "" {
 		infoOutput, _ := templates.Process("admincommands/help/command.reload", nil)