Sandbox (Procedure) - История изменений

Admin в 12:59, 20 апреля 2016

2016-04-20T12:59:24Z

Admin в 09:46, 16 августа 2013

2013-08-16T09:46:03Z

Admin в 08:45, 16 августа 2013

2013-08-16T08:45:18Z

Admin в 19:18, 25 сентября 2012

2012-09-25T19:18:14Z

Admin: Новая страница: «{{Procedures |Name=Sandbox |Description=The '''Sandbox''' Procedure makes the actor look "active" by interacting with various things in his environment. It takes …»

2012-09-25T17:50:52Z

Новая страница: «{{Procedures |Name=Sandbox |Description=The '''Sandbox''' Procedure makes the actor look "active" by interacting with various things in his environment. It takes …»

Новая страница

{{Procedures
|Name=Sandbox
|Description=The '''Sandbox''' Procedure makes the actor look "active" by interacting with various things in his environment. It takes various parameters defining what activities it is allowed to perform while "sandboxing."

#'''Procedures:''' The actor moves around within a specified location and interacts with furniture, idle markers, and other NPCs, looking purposeful and intelligent (or, at least, active and engaged with its environment).
#'''Activities:''' If allowed to eat, it eats breakfast, lunch and dinner at times selected randomly from within an appropriate range of hours (specified by gamesettings). Likewise for sleeping, if allowed to sleep.

|Completes=Never completes.

|Param1=Location
|Type1=Location
|Desc1=Specifies the area that the actor will Sandbox within

|Param2=AllowEating
|Type2=Bool
|Desc2=Specifies whether the actor is allowed to eat while Sandboxing

|Param3=AllowSleeping
|Type3=Bool
|Desc3=Specifies whether the actor is allowed to sleep (in beds) while Sandboxing. (Occurs most often "at night")

|Param4=AllowConversation
|Type4=Bool
|Desc4=Specifies if the actor should decide to talk to other actors while Sandboxing (see: [[:Category:Scenes#Controlling_Random_Conversations|Random Conversations]])

|Param5=AllowIdleMarkers
|Type5=Bool
|Desc5=Specifies whether the actor is allowed to use [[Idle Markers]] while Sandboxing.

|Param6=AllowFurniture
|Type6=Bool
|Desc6=Specifies whether the actor is allowed to use furniture while Sandboxing.

|Param7=AllowSitting
|Type7=Bool
|Desc7=Specifies whether the actor is allowed to use chairs (and other furniture whose markers are of type "Sit" or "Lean", but not "Sleep", and not furniture with the "Special" keyword) while Sandboxing.

|Param8=AllowWandering
|Type8=Bool
|Desc8=Specifies whether the actor is allowed to aimlessly wander while Sandboxing. (Usually False)

|Param9=WanderPreferrefPath
|Type9=Bool
|Desc9=If true, the actor will stay exclusively on preferred-path navmesh triangles when wandering.

|Param10=Energy
|Type10=Float
|Desc10=Used in the formulas for how much time to spend on each type of sub-procedure. See "Procedure Duration Formulas" below.

|Param11=AllowSpecialFurniture
|Type11=Bool
|Desc11= Specifies whether the actor is allowed to use furniture with the "Special" keyword (for instance: grindstones, forges, alchemy tables, arcane enchanters etc.) while Sandboxing.

|Param12=MinWanderDistance
|Type12=Float
|Desc12=The minimum distance away from his current position the actor will decide to wander to when picking a point on the navmesh within the sandbox distance when AllowWandering is true.

|Notes=

*If you are creating a new package, and you want it to include a Sandbox procedure that will end after a specified amount of time, put the Sandbox in a Simultaneous node along with a Wait procedure. (A Simultaneous node completes when any of its children complete, so it will end when the Wait runs out of time.)
* '''They don't eat real food:''' When the Sandbox runs an Eat procedure, it never consumes real food items from the actor's inventory.
* '''Other NPCs can still talk to them:''' Setting AllowConversations to false will not stop other NPCs from starting conversations with the sandboxing NPC. It only prevents the sandboxing NPC from choosing to start conversations with others.
* '''They stay in their sandbox location:''' If a sandboxing actor chooses to talk with an NPC who then moves outside the Location, it will give up pursuit once the target leaves the Location.
* '''They check ownership:''' A sandboxing actor will only use idle markers and furniture if they are not owned, or if they are owned by the NPC or its faction.
* '''They reserve their targets, and respect reservations:''' Sandboxing actors place a reservation on the target ref with which they want to interact. No other sandboxing actor will attempt to use those refs.
* '''You can chain sandbox markers via LinkedRefs but this is kludgy:''' If the Location is a ref with Patrol data and a linked ref, the actor will remain in that location for the duration specified by the Patrol data, and then move along to the LinkedRef, to continue sandboxing there. So, sandboxes can be chained, like they could in Fallout. ''However'': it is now very easy to build (or to ask an expert to build) a specialized package that is a sequence of sandbox procedures, so this is only questionably relevant anymore.

==Action Selection==
When a sandbox package starts up, it builds a list of nearby objects with which it could interact. To select an action, it computes a score for each object, based on the specifics of that object. That score will be set to zero if that object becomes an invalid target, or if it was the same object that the sandbox just selected previously. Each object's score is then weighted by a relative "probability" value based on the ''type'' of the interaction (i.e. sleep, eat, use furniture, use idle markers, or dialogue). The sandbox maintains these probability values over time, adjusting them each time it choses a target object. It drops the probability to zero for the type that was just chosen, and increases the probability for the other types. This ensures that the actor will not select the same kind of action repeatedly (unless it has no other options). For example, after eating, the probability of eating again immediately will be zero, but will increase over time as the actor performs actions other than eating.

==Idle Markers==
Much of the behavior of an NPC using the sandbox package results directly from data attached to objects in the world (idle markers, with collections of potential animation), or simply from the presence of objects in the word (furniture, food, other NPCs), with no extra data required.

See [[Idle Markers]] for more information about what can be specified on a marker.

==Sleeping==
Sleep time and duration is calculated when the sandbox package starts, and then recalculated once per day as necessary.

Sleeping is based on the following gamesettings:
;[[iSandboxSleepStartMin]]: Min time to start sleeping. (Default = 19)
;[[iSandboxSleepStartMax]]: Max time to start sleeping. (Default = 1)
;[[iSandboxSleepDurationMin]]: Minimum duration for sleeping. (Default = 6)
;[[iSandboxSleepDurationMax]]: Maximum duration for sleeping. (Default = 10)

===Start Time===
Rolls randomly for sleep start time between iSandboxSleepStartMin and iSandboxSleepStartMax.

So sandboxing actors can start sleeping between 19:00 and 1:00, using these gamesettings.

===Duration===
Rolls randomly for sleep duration using iSandboxSleepDurationMin and iSandboxSleepDurationMax.

==Eating Meals==
Sandboxing actors calculate their mealtimes when the sandbox package starts, and then recalculate them once per day as necessary.

The meal times are based on the following gamesettings:
;[[iSandboxBreakfastMin]]: Min time to start eating breakfast. (Default = 6)
;[[iSandboxBreakfastMax]]: Max time to start eating breakfast. (Default = 9)
;[[iSandboxLunchMin]]: Min time to start eating lunch. (Default = 11)
;[[iSandboxLunchMax]]: Max time to start eating lunch. (Default = 14)
;[[iSandboxDinnerMin]]: Min time to start eating dinner. (Default = 17)
;[[iSandboxDinnerMax]]: Max time to start eating dinner. (Default = 20)

;[[iSandboxMealDurationMin]]: Min duration for eating a meal. (Default = 0)
;[[iSandboxMealDurationMax]]: Max duration for eating a meal. (Default = 2)

==Other Behaviors==

When not sleeping or eating a meal, the actor can engage in other activities -- if allowed by the package and available within the package radius.

==Procedure Duration Formulas==
Let's work through the duration formulas, using Furniture as an example. Variable names in ''italics'' are the names of gamesettings.
* We start by computing a baseline duration value for using furniture:
BaseDuration = ''fSandboxDurationBase'' * ''fSandboxDurationMultFurniture''
* We then use the procedure's Energy parameter to modify that baseline:
EnergyDuration = BaseDuration * ( 1.0 + Energy * ''fSandboxEnergyMult'' * ''fSandboxEnergyMultFurniture'' )
* Finally, we pick a random duration in a range around the baseline.
MinimumDuration = EnergyDuration * (1.0f - ''fSandboxDurationRangeMult'');
MaximumDuration = EnergyDuration * (1.0f + ''fSandboxDurationRangeMult'');
Duration = random value between MinimumDuration and MaximumDuration

==Semi-Scheduled Activities: Meals and Sleeping==
(All units are in hours.)

* '''Sleeping:''' Sandbox actors who are allowed to sleep will sleep automatically, based on gamesettings.
Bedtime: fSandboxSleepStartMin, fSandboxSleepStartMax
Sleeping duration: fSandboxSleepDurationMin, fSandboxSleepDurationMax

* '''Eating:''' Sandbox actors who are allowed to eat will have regular mealtimes three times per day All units are in hours.
Breakfast: fSandboxBreakfastMin, fSandboxBreakfastMax
Lunch: fSandboxLunchMin, fSandboxLunchMax
Dinner: fSandboxDinnerMin, fSandboxDinnerMax
Meal durations: fSandboxMealDurationMin, fSandboxMealDurationMax

==Relevant Gamesettings==

*'''fMinSandboxRescanSeconds''': Min time (in seconds) before the sandbox re-scans the world for new stuff to interact with.
*'''fMaxSandboxRescanSeconds''': Max time (in seconds) before the sandbox re-scans the world for new stuff to interact with.
*'''fSandboxCylinderTop''': Truncate a spherical sandbox location to a cylinder at this height above the center point. Should be a positive number.
*'''fSandboxCylinderBottom''': Truncate a spherical sandbox location to a cylinder at this height below the center point. Should be a negative number.
*'''fAIWanderDefaultMinDist''': The default minimum wander distance; used if the procedure doesn't specify one.
*'''fSandBoxRadiusHysteresis''': Extra padding so we don't need to repath back into the sandbox when on the edge of it.
*'''fSandBoxDelayEvalSeconds''': Don't re-evaluate our package/procedure for atat // least this long after starting a new sandbox action.
*'''fSandBoxInterMarkerMinDist''': Don't go from one idle marker to another that's closer than this.

|SeeAlso=
*??? None.

}}

@@ Строка 1: / Строка 1: @@
-[[Файл:Symbol_error.png]] '''Статья не закончена!'''
+{{Incomplete}}
-[[Category:Незаконченная статья]]
-−
 {{Procedures
 |Name=Sandbox

@@ Строка 14: / Строка 14: @@
 |Param1=Location
 |Type1=Location
-|Desc1=Указывает локацию, где актер будет взаимодействовать с окружением
+|Desc1=Указывает локацию, где актер будет взаимодействовать с окружением.
 |Param2=AllowEating
 |Type2=Bool
-|Desc2=Указывает, будет ли актер есть во время этого пакета
+|Desc2=Указывает, будет ли актер есть во время этого пакета.
 |Param3=AllowSleeping
@@ Строка 26: / Строка 26: @@
 |Param4=AllowConversation
 |Type4=Bool
-|Desc4=Specifies if the actor should decide to talk to other actors while Sandboxing (see: [[:Category:Scenes#Controlling_Random_Conversations|Random Conversations]])
+|Desc4=Указывает, должен ли актер разговаривать с другими актерами во время этого пакета. (смотри: [[:Category:Scenes#Controlling_Random_Conversations|Случайные разговоры]])
 |Param5=AllowIdleMarkers
 |Type5=Bool
-|Desc5=Specifies whether the actor is allowed to use [[Idle Markers]] while Sandboxing.
+|Desc5=Указывает, может ли актер использовать [[Idle Markers|Idle маркеры]] во время этого пакета.
 |Param6=AllowFurniture
 |Type6=Bool
-|Desc6=Specifies whether the actor is allowed to use furniture  while Sandboxing.
+|Desc6=Указывает, может ли актер использовать фурнитуру во время этого пакета.
 |Param7=AllowSitting
 |Type7=Bool
-|Desc7=Specifies whether the actor is allowed to use chairs (and other furniture whose markers are of type "Sit" or "Lean", but not "Sleep", and not furniture with the "Special" keyword) while Sandboxing.
+|Desc7=Указывает, может ли актер использовать стулья (и другую фурнитуру, маркер которой имеет тип "Sit" или "Lean", но не "Sleep", и не фурнитуру имеющую ключевое слово "Special") во время этого пакета.
 |Param8=AllowWandering
 |Type8=Bool
-|Desc8=Specifies whether the actor is allowed to aimlessly wander while Sandboxing. (Usually False)
+|Desc8=Указывает, может ли актер бесцельно бродить вокруг во время этого пакета. (Обычно стоит значение False)
 |Param9=WanderPreferrefPath
 |Type9=Bool
-|Desc9=If true, the actor will stay exclusively on preferred-path navmesh triangles when wandering.
+|Desc9=Если true, то актер будет оставаться исключительно на preferred-path navmesh triangles когда гуляет.
 |Param10=Energy
 |Type10=Float
-|Desc10=Used in the formulas for how much time to spend on each type of sub-procedure.  See "Procedure Duration Formulas" below.
+|Desc10=Используется в формулах для вычисления длительности времени, затрачиваемого на каждый тип под-процедур. Смотри "Procedure Duration Formulas" ниже.
 |Param11=AllowSpecialFurniture
 |Type11=Bool
-|Desc11= Specifies whether the actor is allowed to use furniture with the "Special" keyword (for instance: grindstones, forges, alchemy tables, arcane enchanters etc.) while Sandboxing.
+|Desc11=Указывает, может ли актер использовать фурнитуру имеющую ключевое слово "Special" (например: grindstones, кузницы, алхимические столы, мистический алтарь зачарования и т.д.) во время этого пакета.
 |Param12=MinWanderDistance

@@ Строка 4: / Строка 4: @@
 {{Procedures
 |Name=Sandbox
-|Description=Процедура '''Sandbox'''("песочница") делает актера "активным", заставляя взаимодействовать с различными вещами в его окружении. Она принимает различные параметры, определяющие, какие виды деятельности ему разрешено выполнять во время пакета "sandboxing."
+|Description=Процедура '''Sandbox'''("песочница") делает актера "активным", заставляя взаимодействовать с различными вещами в его окружении. Она принимает различные параметры, определяющие, какие виды деятельности ему разрешено выполнять во время пакета "песочницы".
-#'''Procedures:'''  The actor moves around within a specified location and interacts with furniture, idle markers, and other NPCs, looking purposeful and intelligent (or, at least, active and engaged with its environment).
+#'''Procedures:'''  Актер двигается по указанной локации и взаимодействует с фурнитурой, idle маркерами, и другими NPC, выглядя целеустремленным и умным (или, можно просто сказать, делает актера активным, взаимодействующим с окружающим миром).
-#'''Activities:'''  If allowed to eat, it eats breakfast, lunch and dinner at times selected randomly from within an appropriate range of hours (specified by gamesettings).  Likewise for sleeping, if allowed to sleep.
+#'''Activities:'''  Если позволить есть, будет есть завтрак, обед или ужин в случайно выбранное время из соответствующего часового диапазона (указанного в игровых настройках). Так же и для сна, если позволить спать.
-|Completes=Never completes.
+|Completes=Никогда не завершается.
 |Param1=Location
 |Type1=Location
-|Desc1=Specifies the area that the actor will Sandbox within
+|Desc1=Указывает локацию, где актер будет взаимодействовать с окружением
 |Param2=AllowEating
 |Type2=Bool
-|Desc2=Specifies whether the actor is allowed to eat while Sandboxing
+|Desc2=Указывает, будет ли актер есть во время этого пакета
 |Param3=AllowSleeping
 |Type3=Bool
-|Desc3=Specifies whether the actor is allowed to sleep (in beds) while Sandboxing. (Occurs most often "at night")
+|Desc3=Указывает, будет ли актер спать (в кроватях) во время этого пакета. (Происходит чаще всего "ночью")
 |Param4=AllowConversation