tAPI tAPI Community Resources - Development assistance for developers, by developers.

Neojin

Neojin

Terrarian
As more tAPI mods are developed and refined, tAPI itself becomes more popular and more people decide to try and create their own mods. Many of these developers are new to tAPI, and a lot of them are new to coding in general. The tAPI thread has become a place where users of all levels go to ask for help and post any code issues. While these posts are well-intentioned, and are often learning opportunities for all of us, it clutters up the tAPI thread which may be better suited for posts about tAPI's development.

I would like this thread to be a place for developers of all experience to post their questions and error logs. And I would like to ask the assistance of any programmer, hobbyist coder, or anyone who's fiddled with making a tConfig or tAPI mod to offer any help they may have to those who post here.

Additionally here are a few resources I would like to highlight that may provide additional help:
 
Last edited:
MrZazder said:
Hey is it possible to make a weapon restricted if you dont have a certain accesory?
Click to expand...
Yes. If your weapon fired a projectile similar to the Terra Blade, you can have the weapons code iterate through the players accessories looking for you're particular accessory, and only fire the projectile if it's found. You can modify any of the values of the weapon such as damage, attack speed, knockback. Or I think you could use the canUse attribute to keep the player from even using the weapon unless an accessory is equipped.
 
Well, I need help...
I keep getting that error:
TAPI.Mods+LoadException: Base Metals.tapi: System.NullReferenceException: Object reference not set to an instance of an object.
at TAPI.ModJsonHandler.HandleTile(ModBase modBase, JsonData j, String fname)
at TAPI.ModJsonHandler.Handle(ModBase modBase)
at TAPI.Mod.<Load>b__0(BinBuffer bb)
at TAPI.Mods.HandleTapiModFile(FPath path, Action`1 action)
at TAPI.Mods.HandleModFile(FPath path, Action`1 action)
at TAPI.Mod.Load()
at TAPI.Mods.Load()
at TAPI.Mods.Load()

It's all started when I created a tile, but I can't fix it, because I don't know why this error happens...

{
"internalName": "CoalTile",
"displayName": "Coal Ore",
"size": [1,1],
"frameWidth": 16,
"frameHeight": 16,
"solid": true,
"blocksLight": true,
"blocksSun": true,
"mergeDirt": true,
"drop": "basemetal:Coal",
"dust": 61,
"treasure": true,
"minPick": 35,
"breaksByPick": true,
"sound": 1,
"soundGroup": 21,
}

{
"displayName": "Coal",
"size": [16,16],
"maxStack": 99,
"value": [0,0,2,0],
"rare": 2,
"useStyle": 1,
"useAnimation": 15,
"useTime": 10,
"autoReuse": true,
"useTurn": true,
"tooltip": "'Good fuel'",
"createTile": "basemetal:CoalTile",
"consumable": true
}
 
UghZan11 said:
Well, I need help...
I keep getting that error:
TAPI.Mods+LoadException: Base Metals.tapi: System.NullReferenceException: Object reference not set to an instance of an object.
at TAPI.ModJsonHandler.HandleTile(ModBase modBase, JsonData j, String fname)
at TAPI.ModJsonHandler.Handle(ModBase modBase)
at TAPI.Mod.<Load>b__0(BinBuffer bb)
at TAPI.Mods.HandleTapiModFile(FPath path, Action`1 action)
at TAPI.Mods.HandleModFile(FPath path, Action`1 action)
at TAPI.Mod.Load()
at TAPI.Mods.Load()
at TAPI.Mods.Load()

It's all started when I created a tile, but I can't fix it, because I don't know why this error happens...

{
"internalName": "CoalTile",
"displayName": "Coal Ore",
"size": [1,1],
"frameWidth": 16,
"frameHeight": 16,
"solid": true,
"blocksLight": true,
"blocksSun": true,
"mergeDirt": true,
"drop": "basemetal:Coal",
"dust": 61,
"treasure": true,
"minPick": 35,
"breaksByPick": true,
"sound": 1,
"soundGroup": 21,
}

{
"displayName": "Coal",
"size": [16,16],
"maxStack": 99,
"value": [0,0,2,0],
"rare": 2,
"useStyle": 1,
"useAnimation": 15,
"useTime": 10,
"autoReuse": true,
"useTurn": true,
"tooltip": "'Good fuel'",
"createTile": "basemetal:CoalTile",
"consumable": true
}
Click to expand...
The error does seem to be happening when tAPI tries to load your tiles json file -
at TAPI.ModJsonHandler.HandleTile(ModBase modBase, JsonData j, String fname)

What are the exact file names used for the tile and item? And are they in the correct folders? (Tiles folder for the tile, Items folder for the item) Also what is your mods internalName? (basemetal?) And what are the names of the texture files for the tile and item?

In your tiles json file, "internalName" is not a standard tile property. It probably doesn't hurt to have it in there, as tAPI supports custom json properties I think, but I would recommend removing that line unless you've inserted it for a particular reason. There's also an unnecessary comma at the end of the last line that I would remove.
 
Neojin said:
The error does seem to be happening when tAPI tries to load your tiles json file -
at TAPI.ModJsonHandler.HandleTile(ModBase modBase, JsonData j, String fname)

What are the exact file names used for the tile and item? And are they in the correct folders? (Tiles folder for the tile, Items folder for the item) Also what is your mods internalName? (basemetal?) And what are the names of the texture files for the tile and item?

In your tiles json file, "internalName" is not a standard tile property. It probably doesn't hurt to have it in there, as tAPI supports custom json properties I think, but I would recommend removing that line unless you've inserted it for a particular reason. There's also an unnecessary comma at the end of the last line that I would remove.
Click to expand...

Yeah, I checked EVERYTHING, but mod started working after putting Coal in recipe of another thingy.But thanks for help anyway:clothierhappy:
 
I need a little help on an error i get when i build the mod:
========================================

LitJson.JsonException: ModInfo Error: The given key was not present in the dictionary. ---> System.Collections.Generic.KeyNotFoundException: The given key was not present in the dictionary.
at System.Collections.Generic.Dictionary`2.get_Item(TKey key)
at tAPI_Builder.MainWindow.<>c__DisplayClass8.<BtnBuild_Click>b__0()
--- End of inner exception stack trace ---
at tAPI_Builder.MainWindow.<>c__DisplayClass8.<BtnBuild_Click>b__0()


I'm pretty new to coding and modding, so this may be quite easy to fix, any idea's?
 
Treldent02 said:
I need a little help on an error i get when i build the mod:
========================================

LitJson.JsonException: ModInfo Error: The given key was not present in the dictionary. ---> System.Collections.Generic.KeyNotFoundException: The given key was not present in the dictionary.
at System.Collections.Generic.Dictionary`2.get_Item(TKey key)
at tAPI_Builder.MainWindow.<>c__DisplayClass8.<BtnBuild_Click>b__0()
--- End of inner exception stack trace ---
at tAPI_Builder.MainWindow.<>c__DisplayClass8.<BtnBuild_Click>b__0()


I'm pretty new to coding and modding, so this may be quite easy to fix, any idea's?
Click to expand...
tAPI Builder is having trouble finding, accessing, or reading your mods ModInfo.json file. Did you include a ModInfo.json file for your mod? If you did include this file, please copy it here so we can take a look at it.
 
Neojin said:
tAPI Builder is having trouble finding, accessing, or reading your mods ModInfo.json file. Did you include a ModInfo.json file for your mod? If you did include this file, please copy it here so we can take a look at it.
Click to expand...
No need now, i've fixed that issue, just forgot to edit the post, it's all fine now
 
Hello!

Is it possible to a have a custom NPC like the guide to have recipes and explain stuff from my mod?

I know how to do basic JSON scripts, however cs is a bit over my head at the moment.

Thanks!
 
what is wrong with this code when i hit the monster i get an error
heres the code (cs made it happen)

using System;
using System.Collections.Generic;
using Microsoft.Xna.Framework.Graphics;

using TAPI;
using Terraria;

namespace WM.NPCs
{
public class RandomNess_Sheet : ModNPC
{
public override bool CanSpawn( int x, int y, int type, Player spawnedOn)
{
if (y <= Main.worldSurface &&
((!Main.bloodMoon && !spawnedOn.zoneEvil && Main.rand.Next(3) == 0)))
{
return false;
}
return false;
}
}
}

and heres the error

System.IndexOutOfRangeException: Index was outside the bounds of the array.
at Terraria.Main.PlaySound(System.Int32 type, System.Int32 x = -1, System.Int32 y = -1, System.Int32 Style = 1)
at Terraria.NPC.StrikeNPC(System.Int32 Damage, System.Single knockBack, System.Int32 hitDirection, System.Boolean crit = False, System.Boolean noEffect = False, System.Single critMult = 2)
at Terraria.NPC.UpdateNPC(System.Int32 i)
 
_Mish said:
Hello!

Is it possible to a have a custom NPC like the guide to have recipes and explain stuff from my mod?

I know how to do basic JSON scripts, however cs is a bit over my head at the moment.

Thanks!
Click to expand...

Almost anything is possible when using code, but using JSON alone severely limits what you can do. Any town NPC would require some C# coding to make them functional. That's where the chat text is set along with their shops, spawn conditions, etc. But adding a new one is one of the easier things to do coding wise. Here's what I recommend:
  • Download the Template Mod available from the first post
  • Use some Zip file program to open the .tapi file. 7zip, winZip, winRar, etc.
  • Place the contents of the file in your 'Documents\My Games\Terraria\tapi\Mods\Sources' folder
  • Use tAPI Builder to build the Template Mod, and verify it works in game
  • Now start looking at Template Mod source files, specifically the files in the NPCs folder. There is an example town NPC in there
  • Try to figure out what each part of the code does, and start changing some of the values to see what happens
  • Once you're more comfortable with the code, build your custom NPC from the Template Mod example code.

felixsmith20 said:
what is wrong with this code when i hit the monster i get an error
heres the code (cs made it happen)

using System;
using System.Collections.Generic;
using Microsoft.Xna.Framework.Graphics;

using TAPI;
using Terraria;

namespace WM.NPCs
{
public class RandomNess_Sheet : ModNPC
{
public override bool CanSpawn( int x, int y, int type, Player spawnedOn)
{
if (y <= Main.worldSurface &&
((!Main.bloodMoon && !spawnedOn.zoneEvil && Main.rand.Next(3) == 0)))
{
return false;
}
return false;
}
}
}

and heres the error

System.IndexOutOfRangeException: Index was outside the bounds of the array.
at Terraria.Main.PlaySound(System.Int32 type, System.Int32 x = -1, System.Int32 y = -1, System.Int32 Style = 1)
at Terraria.NPC.StrikeNPC(System.Int32 Damage, System.Single knockBack, System.Int32 hitDirection, System.Boolean crit = False, System.Boolean noEffect = False, System.Single critMult = 2)
at Terraria.NPC.UpdateNPC(System.Int32 i)
Click to expand...
You're trying to play a sound that doesn't exist in the game. I don't see anywhere in the code you posted where a sound would be used though. Can you post the NPCs JSON file please. Is the problem just when this particular NPC is hit? Or when any NPC is hit with the weapon you're using?

Also, should your first return statement be 'return true'? Both of your return statements return false which means that NPC would never spawn.
 
Neojin said:
Almost anything is possible when using code, but using JSON alone severely limits what you can do. Any town NPC would require some C# coding to make them functional. That's where the chat text is set along with their shops, spawn conditions, etc. But adding a new one is one of the easier things to do coding wise. Here's what I recommend:
  • Download the Template Mod available from the first post
  • Use some Zip file program to open the .tapi file. 7zip, winZip, winRar, etc.
  • Place the contents of the file in your 'Documents\My Games\Terraria\tapi\Mods\Sources' folder
  • Use tAPI Builder to build the Template Mod, and verify it works in game
  • Now start looking at Template Mod source files, specifically the files in the NPCs folder. There is an example town NPC in there
  • Try to figure out what each part of the code does, and start changing some of the values to see what happens
  • Once you're more comfortable with the code, build your custom NPC from the Template Mod example code.


You're trying to play a sound that doesn't exist in the game. I don't see anywhere in the code you posted where a sound would be used though. Can you post the NPCs JSON file please. Is the problem just when this particular NPC is hit? Or when any NPC is hit with the weapon you're using?

Also, should your first return statement be 'return true'? Both of your return statements return false which means that NPC would never spawn.
Click to expand...
fixed it
 
Hi,

How do you create a custom item that drops from a mob? Also how do you create a raw tAPI file?

Thanks
 
You must log in or register to reply here.
Back
Top Bottom