![[PukiWiki]](./skin/BAKIN_logo_92.png "[PukiWiki]"){kind=logo}
This is a FAQ page about creating plug-ins using C#.
The content of this FAQ is based on the inquiries we have received from our users and the responses we have received from our development team.
Please refer to the How to Use Plug-ins section.
You can use a different editor by specifying an association for the sln file other than Visual Studio.
"Conversation" can be achieved with the following method. The position of the window (top, middle, bottom) changes when the 0's are set to 1, 2, 3, etc.
mapScene.ShowDialogue(msg, 0, MenuControllerBase.WindowTypes.DIALOGUE, new AbstractRenderObject.GameContent.DialogueCharacterProperty() new AbstractRenderObject.GameContent.DialogueCharacterProperty(), mapChr.guId);
The DialogueCharacterProperty() parameter can be used to assign a graphic of the speaking cast, but the parameters are generally linked to what can be specified in the panel.
"Message" is the following method. As with conversation, the second parameter, 0, specifies the window position.
mapScene.ShowMessage(stringAttr.value, 0, MenuControllerBase.WindowTypes.MESSAGE, mapChr.guId);
In addition, the "ticker" will be the following method.
mapScene.ShowTelop(msg, 0, MenuControllerBase.WindowTypes.TELOP, new AbstractRenderObject.GameContent.TelopProperty(), mapChr.guId);
ShowDialogue and ShowMessage return an ad hoc id in the return value, so you can use this to execute
mapScene.IsQueuedDialogue(id)
and
mapScene.IsQueuedMessage(id)
to see if the displayed conversation or message is still being displayed (not closed).
This is not possible at the Ver. 1.9 stage.
You can use
Graphics.DrawString (with borders)
or
Graphics.DrawStringSoloColor (without borders).
At this time (ver. 1.9), we do not release methods for text decoration by formatting.
(If you need formatted text decoration, please wait for the release of SpriteManager.)
Please use the following:
var render = catalog.getItemFromName<Yukar.Common.Rom.RenderSettings>("Rendering Setting Name");
mapScene.mapDrawer.setRenderSettings(render);
Please use one of the following two options.
mapChr.playMotion("MotionName")
mapScene.hero.playMotion(("MotionName", 0.2f, true, lockMotion))
lockMotion = Whether to prevent disarming by walking, etc. / locked by true, false for no locking.
To assign a key and apply it, please use the following.
mapScene.hero.getModelInstance().setMorphBlend("KeyName", 0.5f);
To assign a clip and apply it, please use the following.
The parameters are the target, the clip name, the interpolation time, and whether to reset other blendshapes.
ScriptRunner.AddBlendShapeTask(mapScene.hero, "ClipName", 4, false);
Please use the sample code by binding it to an event.
MotionUtil.cs
GetMotionLoopCount to obtain the number of motion loops.
In the case of a one-shot, the motion can be considered complete if it is 1.
PlayMotionImmediately starts motion playback without blending.
Use this when the normal motion playback panel is too much of a distraction from the blending.
Please use the following.
mapChr.SetSubGraphicOpacity
Subgraphic positions are interpreted in mapChr.DisplayObjects as a matrix get function for updating the coordinates of each display object, so they cannot be changed dynamically.
It can be obtained using the following.
((Yukar.Common.Resource.GfxResourceBase)mapChr.getGraphic()).SubGraphics[SubgraphicNumber].useTranslateOnly
Changes are not recommended, as they will directly rewrite the resource.
The following pos, rot, and scale manage these information.
((Yukar.Common.Resource.GfxResourceBase)mapChr.getGraphic()).SubGraphics[SubgraphicNumber]
Changes are not recommended, as they will directly rewrite the resource.
The following useLight manages the on/off information.
((Yukar.Common.Resource.GfxResourceBase)mapChr.getGraphic()).SubGraphics[SubgraphicNumber]
Changes are not recommended, as they will directly rewrite the resource.
This can be done by the following way.
var spIndex = 10; // Sprite Number
var guid = new Guid("c15f94b6-d4a0-46c4-bc43-2db2f64471ac"); // GUID for slice animation
var zoom = 100;
var x = 640;
var y = 360;
mapScene.spManager.ShowPicture(spIndex, guid, zoom, zoom,
Microsoft.Xna.Framework.Color.White, new Yukar.Common.Rom.Script.StringAttr("walk"), x, y);
The GUID of the slice animation can be obtained by right-clicking on the Resources screen > Copy GUID.
Unlike Graphics.drawImage, this can be executed only once and will continue to be displayed thereafter.
It can be moved with "mapScene.spManager.Move" and removed with "mapScene.spManager.Hide".
This is the class used in the "Display Image" event panel.
This feature is not available in the engine because it uses an editor-specific rendering path (pickup buffer).
Please use the following.
mapScene.map.mapCameraRange
if(mapScene.map.mapCameraRange == Rectangle.Empty) is true, it is unset (unrestricted).
Set the model GUID in
mapScene.mapDrawer.renderSettings.skyModel
and then after setting the environment map texture GUID in
mapScene.mapDrawer.renderSettings.reflection
execute
mapScene.mapDrawer.setRenderSettings(mapScene.mapDrawer.renderSettings);
The following code can be used to obtain the cast type of mapChr.
var type = mapChr.rom?.CastType ?? Yukar.Common.Rom.CastType.ALLY;
Refer Collision Detection between Cast Members and Events to make a determination.
It is possible with the following code.
var viewer = mapScene.fieldBattleViewer;
viewer.zoomedScale = 2.0f; // Scale at just the right time to come out
viewer.damageScale = 1.0f; // Eventual scale
viewer.zoomTime = 0.1f; // Time to reach eventual scale
viewer.drawTime = 1.0f; // Time until damage disappears
viewer.damageColor = Microsoft.Xna.Framework.Color.White; // Damage color
viewer.criticalDamageColor = Microsoft.Xna.Framework.Color.Red; // Critical damage color
viewer.criticalDamageColor = Microsoft.Xna.Framework.Color.Red; // Critical damage color
You can also create your own damage rendering process using the attached script.
ChangeFieldBattleViewer.cs
Since the judgment is made randomly based on the critical rate, it cannot simply be determined to occur.
It would be a good idea to use state changes to temporarily increase or decrease the critical rate.
You can still obtain the information by using the following.
mapChr.rom.InvincibleTime
However, the change is not recommended because it would directly modify the Database.
You can switch using the following.
GameMain.instance.data.start.controlMode = Yukar.Common.Rom.GameSettings.ControlMode.NORMAL; GameMain.instance.data.start.controlMode = Yukar.Common.Rom.GameSettings.ControlMode.RESIDENT_EVIL_LIKE;
The scale itself can be obtained with GameMain.instance.catalog.getGameSettings().TalkColliderScale.
However, changes are not recommended since they directly edit the value of the Game Definition.
It is not recommended to change the values for GameSettings in general, as any changes will be retained even after the test play is completed.
It can be obtained and changed using the following.
mapScene.mapFixCamera
In addition, individual enable/disable for each camera operation can be obtained and changed by using the following.
owner.data.start.camLockX owner.data.start.camLockY owner.data.start.camLockZoom owner.data.start.camLockReset
You can use the following to obtain the states of each.
catalog.getGameSettings().CameraAvoidObjects catalog.getGameSettings().CameraAvoidTerrain
However, changes are not recommended since they directly edit the value of the Game Definition.
It is possible to obtain information using the following.
GameMain.instance.catalog.getGameSettings().isTpsMode
However, changes are not recommended since they directly edit the value of the Game Definition.
Not possible. Please use the Game Definition settings as they are.
It is possible to obtain the speed using the following.
GameMain.instance.catalog.getGameSettings().DefaultRotateSpeed
However, changes are not recommended since they directly edit the value of the Game Definition.
Cannot be done.
Instead, create your own process to rotate the camera according to the value of Input.GetAxis() and change the rotation speed accordingly.
It is possible to obtain information using the following.
catalog.getGameSettings().meta.buildVer
The information can then be displayed on the layout by storing it in a variable as shown below.
GameMain.instance.data.system.SetVariable("VariableName", catalog.getGameSettings().meta.buildVer.ToString(), Guid.Empty, false);
However, running C# on the default title screen is not possible as of Ver 1.9.
Therefore, the title screen should be skipped in the Game Definition and used with the in-game title screen in the event.
A sample code is attached.
ConfigGetter.cs
It can be obtained by executing the C# method "GetAutoDash" after assigning it.
Please use the following.
MapCharacter.getRigidBody().setFriction(FrictionValue)
However, since MapCharacter controls friction accordingly, it may become invalid at a moment's notice.
The following method can be used.
mapChr.setOpacityMultiplier(0.5f); // Fully transparent at Transparency 0f
Regarding setOpacityMultiplier, the player is constantly monitoring and applying transparency changes due to state changes, so any changes will be overwritten.
Try setting every frame with AfterDraw().
Please use the code below.
// To open
var lyt = catalog.getLayoutProperties().AllLayoutNodes.FirstOrDefault(x => x.Name == "ItemSelect");
if (lyt != null)
{
GameMain.instance.ShowFreeLayout(lyt.Guid);
}
// To close
var lyt = GameMain.instance.freeLayouts.FirstOrDefault(x => x.LayoutNode.Name == "ItemSelect");
if (lyt != null)
{
GameMain.instance.HideFreeLayout(lyt.LayoutGuid);
}
