Hey Beekeepers!
Some more modding updates today, adding in a whole bunch of new methods based on your feedback. I also added a few balances and tweaks for the base game as well as fixed a few bugs!
For Mod Creators - it's worth noting that I've changed "api_create_object()" to "api_create_obj()" for now in the hope to try and get that function to return an ID (spoilers, it's still not working), so sorry if that breaks anything!
Changes
- Changed Advanced Apiaries to have 7 slots instead of 6 to match with the uncapper + centrifuges
- Bottler now only requires 50bl to fill a bottle instead of 100bl
- Rebalanced a few sell prices around water/resin/honey/mead
- Added totals to each tab within the beebank
- Fixed Hivanium wrongly reducing Crepuscular bees, it now correctly adds 2 hours to Nocturnal bees instead
- Various tweaks to text and labels
Bug Fixes
- Fixed Abbee and Barnabee not showing random stock when you've unlocked more than 10 flowers / bees
- Fixed shop unlocks being off by 3 bees, i.e. saying you needed 8 but you already had 8 but it wasn't counting common/forest/verge
- Fixed Noticeboard quests not actually taking items off you (no more freebees!)
- Fixed putting Rocky Bees in a beebank giving you a bee you shouldn't get until later
- Fixed shop unlock text still referring to levels instead of bee discovery
- Fixed a bug with the world being slightly faded compared to the player
- Fixed Honeycore Crystals not showing the honeycore symbol in the "Sells for" tooltip
- Fixed uncommon bee worldgen in non-demo mode
- Fixed bees being in the wrong coloured hives when generated with structures, i.e. frosty bee in a red hive
- Fixed tier seperators not showing the tier number
- Fixed bee book overview showing /34 when it should of been /35
- Fixed home screen settings/accessibility menus showing a pink cube in the corner
Modding API
- Added a gui() hook to draw on top of the menu layer (like the old draw()) did
- Added a step() hook that runs every step (frame), i.e. every 1/60s. You should only use this for things you need to update visually to be smooth, and not for evil
- Changed the click() hook now has two new parameters, button with "LEFT" "RIGHT" or "MIDDLE", and click_type with "PRESSED" or "RELEASED"
- Changed the draw() hook to be on the overworld layer underneath menus
- Updated the object + menuobject datatypes to include an "invisible" key - invisible objects will not be drawn but will still be interactable based on their sprite bounding box - menu objects will still have a draw script drawn for their menu even though the object will not be visible
- Updated menu object datatypes to include a "center" key - menu objects with this set to true will have their menus centred to the viewport when opened
- Updated the click() hook is now linked to "press" rather than "down" so it doesn't proc every tick the mouse is down
- Updated api_define_gui() to allow you to add a "click" script if you need it
- Updated api_get_objects(), api_get_menu_objects(), api_get_trees(), and api_get_flowers() to have an optional radius parameter based on distance from player instead of all onscreen
- Updated api_define_object() to take an extra optional "draw_script" parameter to specify a custom draw script function to call instead of the default object draw (note: won't be called if this object is invisible!)
- Added api_take_money() and api_take_honeycore() to remove an amount of that currency
- Added api_create_counter() that lets you create a custom counter, say to count between 1-2 in intervals of 0.1 every 1s, resetting back to 1 when it hits 2
- Added api_toggle_menu() that lets you force a menu to open or close
- Added api_destroy_inst() that lets you destroy an instance
- Added api_check_discovery() which lets you see if a give oid has been "discovered" (picked up) by the player
- Added api_define_notification() to let you define a custom notification type + click action to use with api_set_notification()
- Added api_define_bee_recipe() which lets you define a new bee hybrid combination along with a mutation criteria script
- Added api_define_command() which lets you define your own command to run in the in-game console, i.e. "/teleport 100, 50"
- Added api_define_tank() which lets you define a liquid storage tank for a given menu
- Added api_define_flower_recipe() which lets you define a new flower hybrid combination
- Added api_define_trait() which lets you define a custom trait for all bees - you can specify ranges for specific species and set a default option for the rest
- Added api_draw_tank(), a draw helper that draws a liquid storage tank, with the liquid amount and texture + highlights, all for you
- Added api_slot_fill() that lets you start a fill event for a given slot in a menu (requires the menu to have a tank defined)
- Added api_slot_drain() that lets you start a drain event for a given slot in a menu (requires the menu to have a tank defined)
- Added api_get_filename() which gives you the name of the file currently being played by the player
- Added api_get_slot_inst() which lets you get slot instance details from a slot_id
- Added api_set_menu_position() which lets you move a menu (not menu object) to a given position
- Fixed hooks being defined before init() is finished being called, leading to some issues with the draw call getting undefined sprites
- Fixed object oids with "pot" in them crashing when highlighted
- Renamed api_create_object() to api_create_obj()
Modding Docs
- Added new entries for each of the methods above
- Added a new custom datatype entry for "stats" to help explain bee + frame stats
- Fixed api_define_color() using the wrong position in it's example
- Updated api_set_notification() to account for the ability to now define custom ones
- Updated api_create_item() and api_create_object() to add that they return the inst id
- Updated api_get_player_instance() to list some player inst props that might be useful
- Updated api_bee_definition() and api_flower_definition() to fix the color property to use a color datatype not a list