DEV Community: insthync

How to watch Android app log messages with adb logcat for Unity developer

insthync — Sat, 25 Feb 2023 01:43:35 +0000

For those who use Unity to develop Apps, you might not install Android SDK by yourself (Installed by Unity) and never uses adb yet, you can find Android SDK installing path from Unity Editor

In Unity Editor, open menu: Edit -> Preferences…

In Preferences window go to External Tools, then at Android SDK press Copy Path button

Open cmd (Terminal for mac user), use cd command to go to the copied path. For this example, it is D:\Unity\2020.3.26f1\Editor\Data\PlaybackEngines\AndroidPlayer\SDK

If it is in difference drive, you must change it, for example if your Unity installed in D: you must change the drive by enter D: in cmd

Then cd D:\Unity\2020.3.26f1\Editor\Data\PlaybackEngines\AndroidPlayer\SDK

The adb will located in platform-tools folder, so you must enter to the folder by cd platform-tools then you will be able to use adb, you can enter adb logcat to see log messages

If you want it to filter only messages from Unity you may uses this command

adb logcat -s Unity ActivityManager PackageManager dalvikvm DEBUG

[Unity WebGL] How to make it not load content from cache

insthync — Mon, 04 Jul 2022 15:18:21 +0000

How to do it is like when you are going to force it to refresh style or javascript content by add GET parameter follow the files URL for example: version=007, script.js?v=1150. Then we may change parameters after files changed like this: script?v=1151

We can do the same thing with Unity build, in index.html file we can add GET parameter to file URL like following example which I've added id=20220704001

var buildUrl = "Build";
var loaderUrl = buildUrl + "/unity-build.loader.js?id=20220704001";
var config = {
  dataUrl: buildUrl + "/unity-build.data?id=20220704001",
  frameworkUrl: buildUrl + "/unity-build.framework.js?id=20220704001",
  codeUrl: buildUrl + "/unity-build.wasm?id=20220704001",
  streamingAssetsUrl: "StreamingAssets",
  companyName: "Insthync",
  productName: "Unity WebGL",
  productVersion: "0.1",
  showBanner: unityShowBanner,
};

We also able to make Unity add GET parameter when builds with WebGL template macro like this:

var buildUrl = "Build";
var loaderUrl = buildUrl + "/{{{LOADER_FILENAME}}}?id={{{PRODUCT_VERSION}}}";
var config = {
  dataUrl: buildUrl + "/{{{DATA_FILENAME}}}?id={{{PRODUCT_VERSION}}}",
  frameworkUrl: buildUrl + "/{{{FRAMEWORK_FILENAME}}}?id={{{PRODUCT_VERSION}}}",
  codeUrl: buildUrl + "/{{{CODE_FILENAME}}}?id={{{PRODUCT_VERSION}}}",
  streamingAssetsUrl: "StreamingAssets",
  companyName: "{{{COMPANY_NAME}}}",
  productName: "{{{PRODUCT_NAME}}}",
  productVersion: "{{{PRODUCT_VERSION}}}",
  showBanner: unityShowBanner,
};

If we set Version (in Build Settings) to 1.0 then when it built, codes in index.html will be like:

var buildUrl = "Build";
var loaderUrl = buildUrl + "/unity-build.loader.js?id=1.0";
var config = {
  dataUrl: buildUrl + "/unity-build.data?id=1.0",
  frameworkUrl: buildUrl + "/unity-build.framework.js?id=1.0",
  codeUrl: buildUrl + "/unity-build.wasm?id=1.0",
  streamingAssetsUrl: "StreamingAssets",
  companyName: "Insthync",
  productName: "Unity WebGL",
  productVersion: "1.0",
  showBanner: unityShowBanner,
};

You can find more information about template macro from this link.

Addressable Asset not being refreshed?

We can do the same thing by make changes to StreamingAssets\aa\settings.json file.

Find {"m_Keys":["AddressablesMainContentCatalogRemoteHash"],"m_InternalId": in settings.json.

It will have codes like this "m_InternalId":"https://yourgameassets.com/addressable/WebGL/catalog_2022.07.04.00.00.00.hash"

Then just add GET parameter like this

"m_InternalId":"https://yourgameassets.com/addressable/WebGL/catalog_2022.07.04.00.00.00.hash?version=001"

Create game with MMORPG KIT-Part 3-Map's navmesh and first monster

insthync — Sun, 26 Sep 2021 12:53:31 +0000

In this part, I will setup map's navmesh to make monsters able to move (and also make player's character able to move by point click controlling) and create first monster character

Create map's nav mesh

Open map scene (000_Leveling_Test) first, because we are going to create nav mesh for this map.

Then open Navigation window from menu Window -> AI -> Navigation.

Then in Navigation window, select Object tab, select sources for nav mesh creation, in this scene has only one mesh (because we made this scene just for testing). It is Floor, select it and tick on Navigation Static

Then select Bake tab click Bake button, and nav mesh will be created, save the scene, and... done!.

Create new monster

You can create new character easily by Character Entity Creator dialog

Before you use this tool, you have to prepare character model prefab

I will uses characters from RPG Monster Wave Polyart

My first monster that I am going to create is Slime.

So I will prepare Slime character model prefab by duplicate Slime prefab from Assets/RPG Monster Wave Polyart/Prefabs/PolyartDefault by select it, press CTRL+D.

Then drag duplicated prefab to Assets/Leveling/Prefabs/MonsterCharacters and rename it to Slime.

And delete all components except Animator.

Now a new character model preparation is done, next I'm going to create new monster character entity based on this character model.

Open the dialog from menu MMORPG KIT -> Character Entity Creator (3D)

Then I will set filename to Slime, set Character entity type to Monster Character Entity, set Entity movement type to Nav Mesh, Select game database which created for this project (It is LevelingGameDb which was created in first part) and set FBX to prepared character model prefab

After set data in the dialog, press Create button, then it will shows folder choosing dialog, select folder which you want to save, Mine will be saved to Assets/Leveling/GameData/MonsterCharacters/Slime

Then data will be created in selected folder

And also added to the game database

Set character animations

RPG Monster Wave Polyart
have an animations for characters, so I will show how to set character's animations by use animations from the package.

To set character's animations, you have to open the character entity prefab. For this character, I've saved it to Assets/Leveling/GameData/MonsterCharacters/Slime so I will go to the folder and open prefab

Then find attached Playable Character Model component

In Default Animations, set following clips

Set Assets/RPG Monster Wave Polyart/Animations/Slime/IdleNormal_Slime_Anim to Default Animations -> Idle State -> Clip.
Set Assets/RPG Monster Wave Polyart/Animations/Slime/Run_Slime_Anim to Default Animations -> Move States -> Forward State -> Clip.
Set Assets/RPG Monster Wave Polyart/Animations/Slime/GetHit_Slime_Anim to Default Animations -> Hurt State -> Clip.
Set Assets/RPG Monster Wave Polyart/Animations/Slime/Die_Slime_Anim to Default Animations -> Dead State -> Clip.

In Default Animations -> Right Hand Attack Animations set 2 attack animations by uses clip from Assets/RPG Monster Wave Polyart/Animations/Slime/Attack01_Slime_Anim and Assets/RPG Monster Wave Polyart/Animations/Slime/Attack02_Slime_Anim

Now, your character is ready to use, let's add it to the game map.

Add monster to the map

There are 2 ways to add monster to the map.

First, drag a prefab to the map scene, that is it.

Second, create game object and attach Monster Spawn Area component

Set Slime character entity prefab to Monster Spawn Area component -> Prefab field

Set random level and spawning amount as you wish, I will set spawning amount to 10 so when start game it will spawn 10 of Smiles

Then test the game, you will see 10 Slimes spawned.

Extra - Why I can't attack monster

You can't attack monster which created by Character Entity Creator because it has no collider attached yet, you can attach any collider to the prefab but you have to set it as trigger collider.

For the Slime, I will attach box collider.

Then save the prefab, test the game again, you will be able to click on monster to attack.

Extra - Why monster not moving or do anything when I attack it

It is because there is no monster activity component attached to the Slime yet, you have to attach Monster Activity Component to the Slime prefab.

Create game with MMORPG KIT-Part 2-Map and first Character

insthync — Tue, 29 Jun 2021 09:33:18 +0000

In this part, I will create empty scene which has a floor for character movement testing and the first character.

Map preparation

You can create new scene from menu File -> New Scene

Delete Main Camera, because it will instantiate gameplay camera prefab as main character when player enter map scene, it should not have more than one main camera in the map scene

Map scenes must have EventSystem for UI event handling, so you have to add it by menu GameObject -> UI -> Event System

I will create this scene for character movement testing only, so I will just add a cube and set its scale to [100, 1, 100], position is [0, -0.5, 0]

Then save the scene, I've set it name to 000_Leveling_Test, saved it to Assets/Leveling/Scenes/Maps.

And don't forget to add it to Scenes In Build

After that, you have to create map info for the map scene.

Open Game Database Editor dialog from menu MMORPG KIT -> Game Database

Choose your game database

Select Map Info section, then click Create

Choose kind of map info, for generic maps uses MultiplayerARPG.MapInfo

Then save it, I will save it to Assets/Leveling/GameData/Maps, name: 000_Leveling_Test

Set created scene to Scene field

Create new character

You can create new character easily by Character Entity Creator dialog

Before you use this tool, you have to prepare character model prefab

I will uses characters from Modular RPG Hero Polyart package

I will prepare character model prefab based on ForExternalAnimations prefab which located in Assets/ModularRPGHeroesPolyArt/Prefabs/CharacterBaseForExternalAnimations, duplicate it by select it, press CTRL+D.

Then drag duplicated prefab to Assets/Leveling/Prefabs/PlayerCharacters and rename it to Human.

And delete all components except Animator

Now a new character model preparation is done, next I'm going to create new player character entity based on this character model.

Open the dialog from menu MMORPG KIT -> Character Entity Creator (3D)

Then I will set filename to Human, set Character entity type to Player Character Entity, set Entity movement type to Character Controller, Select game database which created for this project (It is LevelingGameDb which was created in first part) and set FBX to prepared character model prefab

Then data will be created in selected folder

And also added to the game database

Then you can press play from 00_Leveling_Init scene to try creating the character

You'll noticed it has no animation, so we've to set it animation

Set character animations

Modular RPG Hero Polyart have an animations for characters, so I will show how to set character's animations by use animations from the package.

To set character's animations, you have to open the character entity prefab. For this character, I've saved it to Assets/Leveling/GameData/PlayerCharacters/Human so I will go to the folder and open prefab

Then find attached Playable Character Model component

In Default Animations, set following clips

Set Assets/ModularRPGHeroesPolyArt/Animations/NoWeapon/Idle_noWeapon to Default Animations -> Idle State -> Clip.
Set Assets/ModularRPGHeroesPolyArt/Animations/NoWeapon/NormalRun_noWeapon to Default Animations -> Move States -> Forward State -> Clip.
Set Assets/ModularRPGHeroesPolyArt/Animations/NoWeapon/JumpStart_noWeapon to Default Animations -> Jump State -> Clip.
Set Assets/ModularRPGHeroesPolyArt/Animations/NoWeapon/JumpAir_noWeapon to Default Animations -> Fall State -> Clip.
Set Assets/ModularRPGHeroesPolyArt/Animations/NoWeapon/JumpEnd_noWeapon to Default Animations -> Landed State -> Clip.
Set Assets/ModularRPGHeroesPolyArt/Animations/NoWeapon/GetHit_noWeapon to Default Animations -> Hurt State -> Clip.
Set Assets/ModularRPGHeroesPolyArt/Animations/NoWeapon/Die_noWeapon to Default Animations -> Dead State -> Clip.
Set Assets/ModularRPGHeroesPolyArt/Animations/NoWeapon/PickUp_noWeapon to Default Animations -> Pickup State -> Clip.

Then test it, create new character and move in map scene. (W/A/S/D/SPACE)

Character won't be able to play attack animation yet, so let's set it up.

Set character attack animations

Open the character entity prefab again, then in Playable Character Model component, Default Animations -> Right Hand Attack Animations I'll set 2 attack animations

Then the important settings other than State -> Clip is Trigger Duration Rates which is rate of Clip's duration at when it should hit enemy, you can find it from animation clip previewing.

For example NormalAttack01_SingleTwohandSword clip, the character will swinged and should hit at 50%, so I will set Trigger Duration Rates to 0.5.

After set the character animation, test it again, now press attack (V) button, it will play attack animations randomly.

Extra - I want to change default equipment

You can change default equipment by open character entity prefab, then activate/deactivate meshes as you wish

If you use other model packages, it may have difference mesh setup, you may not able to activate/deactivate to change default equipment

Extra - Why character's HP is decreasing

You may found that character's HP is decreasing and doubt why it's happening. It's because of gameplay rule, its default settings was set to decrease character's HP while character is hungry, you can change the settings to not decrease character's HP.

Create game with MMORPG KIT-Part 1-Project preparation

insthync — Sun, 27 Jun 2021 18:58:16 +0000

In this part, I will prepare the project based on the kit's demo, by duplicates init scene which is the scene which has a game instance which will initializing game data when game starting, home scene which will be loaded after game instance initialized it's a scene for start game menu, character management, option and so on (Up to you) and then create new game database but still uses demo's in-game objects and UIs.

Folders preparation

Let's start from create folders
You can create folders in for an assets by right click in Project tab, then select menu Create -> Folder

I've create following folders:

Assets/Leveling
Assets/Leveling/GameData
Assets/Leveling/GameData/Items
Assets/Leveling/GameData/MonsterCharacters
Assets/Leveling/GameData/PlayerCharacters
Assets/Leveling/GameData/Maps
Assets/Leveling/Scenes
Assets/Leveling/Scenes/Maps

I've defined the project name to Leveling so I create Leveling folder which will have content for this project, project folder structure may changes later.

Game database, NPC database, Warp portal database and gameplay rule preparation

Then I will create new game database, NPC database, warp portal database and gameplay rule for this project by

Right click Assets/Leveling/GameData folder, then select menu Create -> Create GameDatabase -> Game Database (I've set it name to LevelingGameDb)
Right click Assets/Leveling/GameData folder, then select menu Create -> Create GameDatabase -> Npc Database (I've set it name to LevelingNpcDb)
Right click Assets/Leveling/GameData folder, then select menu Create -> Create GameDatabase -> Warp Portal Database (I've set it name to LevelingWarpPortalDb)
Right click Assets/Leveling/GameData folder, then select menu Create -> Create GameplayRule -> Default Gameplay Rule (I've set it name to LevelingGameplayRule)

Init scene and home scene preparation

After that I will duplicate scenes from the demo, so when I made changes to my project it won't affect the demo.

Open folder Assets/UnityMultiplayerARPG/Demo/Scenes/ select 00Init and 01Home then press CRTL + D keys to duplicate (For Mac users, may use CMD + D keys)

Then move it to Assets/Leveling/Scenes folder by drag it and drop it, and rename it (In this post, I will set name to 00_Leveling_Init and 01_Leveling_Home

After that open 00_Leveling_Init scene to set created databases , gameplay rule and duplicated home scene to game instance

Save the scene, then add duplicated scenes to Scenes In Build by open the dialog from menu File -> Build Settings...

Then drag duplicated scenes: 00_Leveling_Init and 01_Leveling_Home into Scenes In Build section

Now you can start game from 00_Leveling_Init scene so you have to open 00_Leveling_Init before press play. When press play it will load 01_Leveling_Home scene but still can't create character yet because it doesn't has any character to create yet.

In next part, I will tell you how to create new map and character.

[Note] Installing SVN Server to Droplets

insthync — Sun, 28 Feb 2021 11:57:09 +0000

In this post, I will write about how I set up SVN server to Ubuntu 18.04 (LTS) x64 droplets

Then enter to ssh server by the address with command:

ssh root@{Server address}

Installing Apache and SVN module

Installing Apache

sudo apt-get update
sudo apt-get install apache2

Installing SVN module

sudo apt-get install subversion libapache2-mod-svn

Enable required modules

sudo a2enmod dav dav_svn authz_svn

Restart Apache

sudo service apache2 restart

Create new repository

Create repositories storing directory

sudo mkdir -p /var/lib/svn/

Set repositories storing directory permissions

sudo chown -R www-data:www-data /var/lib/svn
sudo chmod -R 775 /var/lib/svn

Create users into file: /etc/apache2/dav_svn.passwd

sudo touch /etc/apache2/dav_svn.passwd
sudo htpasswd -m /etc/apache2/dav_svn.passwd {Your Username}

Set SVN module config

sudo nano /etc/apache2/mods-enabled/dav_svn.conf

Copy following config content to the file

<Location /svn>

   DAV svn
   SVNParentPath /var/lib/svn

   AuthType Basic
   AuthName "Subversion Repository"
   AuthUserFile /etc/apache2/dav_svn.passwd
   Require valid-user

</Location>

Create new SVN repository into repositories storing directory (/var/lib/svn/)

sudo svnadmin create /var/lib/svn/{Repository name}

Restart Apache

sudo service apache2 restart

Try it by using web-browser, browse: http://{Server address}/svn/{Repository name}

Add GRPC to Unity project checklist

insthync — Sun, 05 Apr 2020 07:22:20 +0000

Find unitypackge from daily build list (https://packages.grpc.io/)
Extract plugins to project asset folder
Your project target must be .NET 4.x Equivalent (Edit → Project Settings → Player → Configuration → Scripting Runtime Version)

Service Compiler

I also made a tool to compile GRPC’s .proto files for Unity based on protobuf-unity project, you can get it from this link.

There is a new field to set grpc_csharp_plugin path

You also can find built protoc and grpc_csharp_plugin from daily build list (https://packages.grpc.io/)