TechbloxModdingAPI/GamecraftModdingAPI/Blocks/Placement.cs

56 lines
2.3 KiB
C#
Raw Normal View History

2020-01-03 00:14:26 +00:00
using System;
2020-01-04 00:54:35 +00:00
2020-01-03 00:14:26 +00:00
using Unity.Mathematics;
using Svelto.ECS;
2020-01-03 00:14:26 +00:00
2020-01-04 00:54:35 +00:00
using GamecraftModdingAPI.Utility;
2020-01-03 00:14:26 +00:00
namespace GamecraftModdingAPI.Blocks
{
/// <summary>
2020-02-25 23:05:13 +00:00
/// Common block placement operations.
/// The functionality in this class is for build mode.
2020-01-03 00:14:26 +00:00
/// </summary>
public static class Placement
{
private static PlacementEngine placementEngine = new PlacementEngine();
/// <summary>
2020-02-25 23:05:13 +00:00
/// Place a new block at the given position. If scaled, position means the center of the block. The default block size is 0.2 in terms of position.
2020-01-03 00:14:26 +00:00
/// Place blocks next to each other to connect them.
2020-02-25 23:05:13 +00:00
/// The placed block will be a complete block with a placement grid and collision which will be saved along with the game.
2020-01-03 00:14:26 +00:00
/// </summary>
/// <param name="block">The block's type</param>
/// <param name="color">The block's color</param>
/// <param name="darkness">The block color's darkness (0-9) - 0 is default color</param>
/// <param name="position">The block's position in the grid - default block size is 0.2</param>
2020-01-15 19:41:50 +00:00
/// <param name="rotation">The block's rotation in degrees</param>
2020-01-03 00:14:26 +00:00
/// <param name="uscale">The block's uniform scale - default scale is 1 (with 0.2 width)</param>
/// <param name="scale">The block's non-uniform scale - 0 means <paramref name="uscale"/> is used</param>
2020-01-03 00:14:26 +00:00
/// <param name="playerId">The player who placed the block</param>
/// <returns>The placed block's ID or null if failed</returns>
public static EGID? PlaceBlock(BlockIDs block, float3 position,
2020-01-15 19:41:50 +00:00
float3 rotation = default, BlockColors color = BlockColors.Default, byte darkness = 0,
int uscale = 1, float3 scale = default, uint playerId = 0)
2020-01-03 00:14:26 +00:00
{
if (placementEngine.IsInGame && GameState.IsBuildMode())
{
2020-01-04 00:54:35 +00:00
try
{
return placementEngine.PlaceBlock(block, color, darkness, position, uscale, scale, playerId, rotation);
2020-01-04 00:54:35 +00:00
}
catch (Exception e)
{
Logging.MetaDebugLog(e);
}
2020-01-03 00:14:26 +00:00
}
return null;
2020-01-03 00:14:26 +00:00
}
public static void Init()
{
GameEngineManager.AddGameEngine(placementEngine);
}
}
}