Go to file
Andrey01 e40685f014
Amended the crafting recipes guide
2019-08-20 21:26:11 +03:00
models Moved invalid content to 'old' folder 2019-07-29 00:26:44 +03:00
old Moved invalid content to 'old' folder 2019-07-29 00:26:44 +03:00
textures Added wheel, replaced tires_bunch item to wheels_bunch, optimized kamaz texture 2019-08-18 22:48:32 +03:00
LICENSE Initial commit 2019-04-28 22:08:32 +03:00
README.md Amended the crafting recipes guide 2019-08-20 21:26:11 +03:00
api.lua Made a smoother vehicles rotating 2019-08-19 23:35:41 +03:00
init.lua Added wheel, replaced tires_bunch item to wheels_bunch, optimized kamaz texture 2019-08-18 22:48:32 +03:00
mod.conf Added diesel ICE and elements for it, steering wheel 2019-07-29 00:21:00 +03:00
screenshot.png Fixed the bus texture display and added a mod screenshot 2019-06-25 22:55:40 +03:00

README.md

Advanced Vehicles. Current version is 1.0.1-Release.

Description


Adds smart different cars (passenger cars, trucks, buses, service). This mod introduces little API to register cars with analogical parameters that use the mod (see *API Documentation)

API Documentation


###adv_vehicles.register_vehicle(vehicle_name, vehicle_properties, vehicle_item) --Registers a vehicle in the game as an entity and an item spawner for it.

vehicle_name is entity string. vehicle_properties is a table with following fields: hp_max, mass, is a property that sets a value of vehicle mass in tons. Necessary for calculating of the gravity. max_vel, measured in metres in sec. cbox, is collision box. model, textures, seats, is a table that contains a data about each seat (busy_by, pos fields). Key should be string containing a sort of seat (driver or passenger). player_eye_offset, is pos table vehicle_item is a table with item spawner data. Fields: description, inv_image, craft_recipe.

###adv_vehicles.rotate_point_around_other_point(circle_center_pos, rotating_point_pos, fixed_point_yaw, current_point_yaw) --This method implements affine transformation of a point rotating_point_pos rotation along a circle with circle_center_pos center.

circle_center_pos is position table. rotating_point_pos is position table. fixed_point_yaw is the last fixed yaw of a vehicle (saving in self.fixed_veh_rotate_angle). current_point_yaw is current yaw of a vehicle.

###adv_vehicles.attach_player_to_veh(player, vehicle, seated, model, animation) --Attaches a player to the vehicle.

player is PlayerObjectRef. vehicle is ObjectRef. seated is "driver" or "passenger" keys depending on which field in seats_list used. model is vehicle model (.b3d format). animation is a table with x, y fields

###adv_vehicles.detach_player_from_veh(player, vehicle, seated, model, animation) --Opposite to adv_vehicles.attach_player_to_car. Detaches a player from the car and the same arguments.

###adv_vehicles.pave_vector(vehicle, old_acc_vect_pos, old_yaw) --Paves the vector from '0' point relatively to the car origin towards to old_acc_vect_pos. old_yaw is a integer value that saving in self.fixed_veh_rotate_angle. This method should be caused continuously per 0.1 second to recalculate the car direction.

###adv_vehicles.rotate_collisionbox(vehicle, yaw) This method is WIP and doesnt work properly currently.

###adv_vehicles.collide(vehicle) Calculates elastic force of surface on that vehicle has fallen. It depends currently only on the vehicle velocity. It will also damage the vehicle and objects sitting inside. Damage rate also depends from the velocity.

###adv_vehicles.vehicle_braking(vehicle, vector_l) vector_l is a just coefficient for braking calculating. The above value, the braking is faster. This method is permanently called in the globalstep.

###adv_vehicles.vehicle_handle(vehicle, controls, yaw) controls is a table resulted from get_player_control().

Executes the vehicle driving (turns, forward/backward going)

Crafting Recipes Guide


L/B = Luxury Decor or Basic Materials

Basic Items

Items that needed to craft any of vehicle sort.

Car Frame
Basic element of crafting of all vehicles. Available only before 1.0.0-RC2.


L/B plastic_sheet L/B plastic_sheet L/B plastic_sheet

L/B plastic_sheet L/B plastic_sheet L/B plastic_sheet

L/B plastic_sheet


Car Frame Material
Basic element of crafting of all vehicles. Available only since 1.0.0-RC2.


default:steel_ingot === L/B plastic_sheet === adv_vehicles:aluminium_dust

default:steel_ingot === L/B plastic_sheet === adv_vehicles:aluminium_dust

L/B plastic_sheet === xpanes:pane_flat

L/B plastic_sheet


Wheels Bunch

A group of wheels items. An element is needed for crafting of all vehicles. Just made to save a room in the crafting grid for other items.


adv_vehicles:wheel === adv_vehicles:wheel === adv_vehicles:wheel

adv_vehicles:wheel


Two Red Headlights

A group of red headlights. Just made to save a room in the crafting grid for other items.


adv_vehicles:headlight_red === adv_vehicles:headlight_red


Two White Headlights

A group of white headlights. Just made to save a room in the crafting grid for other items.


adv_vehicles:headlight_white === adv_vehicles:headlight_white


Diesel ICE (Internal Combustion Engine)

An important part of any vehicle without that no one can move in real. Crafted from aluminium dust, four cylinders and two steel ingots.


adv_vehicles:cylinder === default:steel_ingot === default:steel_ingot

adv_vehicles:cylinder === adv_vehicles:cylinder

adv_vehicles:cylinder === adv_vehicles:aluminium_dust


Steering Wheel

Needed for crafting of any vehicle.


L/B plastic_sheet === L/B plastic_sheet === adv_vehicles:aluminium_dust

dye:black


Ores Generation and their stuff

Heres about the ores generation and all recipes what concerned to using these ores.

Aluminium

Generates below -40 y coord. Introduces itself a long sheet of ores. *Gives 1-6 aluminium lumps. *Generates rarer than silicon.

Silicon

Generates below -60 y coord. Shapes small clusts of ores. *Gives 1-4 silicon lumps. Most frequently generated.

Phosphorus

Generates below -100 y coord. Introduces blobs of ores. *Gives 1-3 phosphorus lumps. Very rare

Aluminium Lump

Mined aluminium ore.

Aluminium Dust

Crafted from one aluminium lump.

Silicon Lump

Mined from silicon ore.

Silicon Dust

Crafted from silicon lump.

Phosphorus Lump

Mined from aluminium ore.

Phosphorus Dust

Mined from phosphorus lump.

Aluminium and Silicon Dusts

A group of aluminium dust and silicon dust. Needed for alloying of silumin.

Silumin Ingot

An alloy is consisted of aluminium and silicon dusts. Needed for crafting of piston, crankshaft and cylinder.

Red LED

A light-emitting diode of red color.


adv_vehicles:aluminium_dust === L/B plastic_sheet === default:copper_ingot


Green LED

A light-emitting diode of green color.


adv_vehicles:phosphorus_dust === L/B plastic_sheet === default:copper_ingot


Blue LED

A light-emitting diode of blue color.


adv_vehicles:silicon_dust === L/B plastic_sheet === default:copper_ingot


White LED

A light-emitting diode of white color.


adv_vehicles:red_led === adv_vehicles:blue_led === adv_vehicles:green_led


ICE (Internal Combustion Engine) Components.

Here are listed crafting recipes of ICE components.

Piston

A piston that implements fuel compression.


default:steel_ingot === default:steel_ingot === default:steel_ingot

adv_vehicles:silumin_ingot === adv_vehicles:silumin_ingot

adv_vehicles:silumin_ingot


Crankshaft


default:steel_ingot === default:steel_ingot

adv_vehicles:silumin_ingot

adv_vehicles:silumin_ingot


Cylinder

A working chamber of the ICE.


adv_vehicles:piston

adv_vehicles:crankshaft

adv_vehicles:silumin_ingot


Vehicles.

A list of crafting recipes of vehicles.

BMW 118 Car

Before 1.0.0-RC2.


adv_vehicles:car_frame dye:blue

adv_vehicles:wheel adv_vehicles:wheel adv_vehicles:wheel

adv_vehicles:wheel L/B plastic_sheet


Volvo Bus

Before 1.0.0-RC2.


adv_vehicles:car_frame dye:yellow dye:yellow

adv_vehicles:wheel adv_vehicles:wheel adv_vehicles:wheel

adv_vehicles:wheel L/B plastic_sheet default:steel_ingot


Kamaz Truck

Before 1.0.0-RC2.


adv_vehicles:car_frame dye:grey dye:white

adv_vehicles:wheel adv_vehicles:wheel adv_vehicles:wheel

adv_vehicles:wheel L/B plastic_sheet default:steel_ingot


BMW 118 Car

Since 1.0.0-RC2.


adv_vehicles:car_frame_material === adv_vehicles:tires_bunch === adv_vehicles:two_red_headlights

adv_vehicles:car_frame_material === adv_vehicles:diesel_ice === adv_vehicles:two_white_headlights

adv_vehicles:car_frame_material === adv_vehicles:steering_wheel === dye:blue


Volvo Bus

Since 1.0.0-RC2.


adv_vehicles:car_frame_material === adv_vehicles:tires_bunch === adv_vehicles:two_red_headlights

adv_vehicles:car_frame_material === adv_vehicles:diesel_ice === adv_vehicles:two_white_headlights

adv_vehicles:car_frame_material === adv_vehicles:steering_wheel === dye:yellow


Kamaz Truck

Since 1.0.0-RC2.


adv_vehicles:car_frame_material === adv_vehicles:tires_bunch === adv_vehicles:two_red_headlights

adv_vehicles:car_frame_material === adv_vehicles:diesel_ice === adv_vehicles:two_white_headlights

adv_vehicles:car_frame_material === adv_vehicles:steering_wheel === dye:white


Miscellaneous Stuff

Tire

An element that intended for crafting of tires bunch


L/B plastic_sheet === L/B plastic_sheet === dye:dark_green

L/B plastic_sheet


Wheel

An element for crafting of wheels_bunch.


adv_vehicles:car_frame_material === default:steel_ingot

adv_vehicles:aluminium_dust === adv_vehicles:tire


Red Headlight

Back car headlight. Crafted from seven red_leds, one plastic_sheet and one steel ingot.


adv_vehicles:red_led === adv_vehicles:red_led === adv_vehicles:red_led adv_vehicles:red_led === L/B plastic_sheet === adv_vehicles:red_led adv_vehicles:red_led === default:steel_ingot === adv_vehicles:red_led


White Headlight

Front car headlight. Crafted from four white leds, one plastic_sheet and one steel ingot.


adv_vehicles:white_led === adv_vehicles:white_led === adv_vehicles:white_led adv_vehicles:white_led === L/B plastic_sheet === adv_vehicles:white_led adv_vehicles:white_led === default:steel_ingot === adv_vehicles:white_led