Proto commits in DCS-gRPC/rust-server

These commits are when the Protocol Buffers files have changed: (only the last 100 relevant commits are shown)

2026-06-09

Api compatibility improvements (#299) * Add various fixes related to DCS api changes * adjustments for linter * Return id_ for weapon objects and unknown objects * add entry for CHANGELOG.md

The documentation is generated from this commit.

2026-06-03

Add Unit.GetSensors RPC and sensor typing (#288) * Add Unit.GetSensors RPC and sensor typing Introduce UnitService.GetSensors to expose DCS Unit:getSensors() with typed outputs for radar, IRST, RWR, and optical sensors. - Add proto messages: SensorCategory, Sensor, RadarSensor, IrstSensor, RwrSensor, OpticalSensor, DetectionDistanceAir, Hemisphere - Implement GRPC.methods.getSensors in Lua - Wire UnitService::get_sensors in Rust - Classify sensors by type id (0=optical, 1=radar, 2=irst, 3=rwr); * fix: lint issue with protolint on RwrSensor and OpticalSensor NewLine

Add coalition, toAll and playerName to sendchat event (#298)

2025-11-03

Add world.searchObjects RPC with volume support (#287) * Add world.searchObjects RPC with volume support Expose DCS’ world.searchObjects via WorldService/SearchObjects with full volume support (sphere, box, segment, pyramid). - Proto: define SearchObjectsRequest with SearchVolume (sphere/box/ segment/pyramid) using InputPosition for geo points; response returns dcs.common.v0.Target[] to reuse the existing union object type - Lua: implement GRPC.methods.searchObjects; build DCS volume tables (world.VolumeType.*) and flattened shapes; return objects wrapped in Target oneof - Rust: wire WorldService::search_objects to Lua method

2024-11-10

Add Parler based TTS (POC)

2024-11-05

Added RunwayTouch and RunwayTakeoff for more accurate TakeOff and Land events (#272) Co-authored-by: dutchie032 <dutchie032>

2024-09-28

Added MetadataService with GetHealth and GetVersion (#267) Added an additional service. "MetadataService" for admin functionality that does not touch DCS itself. GetHealth => for getting the gRPC server status GetVersion => for getting the version of the cargo package. Nothing too fancy, but can be handy for the client and verification. Co-authored-by: dutchie032 <dutchie032>

2024-08-30

Feature/get draw argument value (#264) Added `unit:getDrawArgumentValue(name)` to the rust-server. This is handy for checking things on units like: - doors open/close - flaps - hook for carrier aircraft and more Tested with F-14 on the deck with hook down (cannot go down 100% due to it touching the ground):

2024-05-24

Add Piper as TTS provider

2023-10-19

Add events and methods to track SRS clients (#230)

2023-07-02

Merge branch 'main' into orbit

2023-04-02

Add Orbit and Racetrack commands.

2023-01-31

add ActivateGroup, DestroyGroup, DestroyUnit (#214)

2022-12-06

Add `GRPC.tts(...)` Lua API (#202) * Add GRPC.tts(...) Lua API * Use InputPosition for positions in requests * Add note about InputPosition to changelog

2022-12-04

Implement TTS service (#194) * Implement TTS service * Move TTS provider settings into config file * Increase max line length of proto files to 100 characters * Use protolint default rules only * Add speak duration to TTS response * Rename wait to async in TransmitRequest * Add optional plain text to TTS request * Disable Windows TTS on any non-Windows OS * Document TTS config options in README * Move SRS address from TTS request into config file * Fix code formatting * Fix build on Linux * Rename text_ssml/text_plain to ssml/plaintext * Add doc comment to Transmit RPC method * Rename TTS request name field to srs_client_name * Add srs_client_name to TTS event * Add changelog entry

Add `GetBallisticsCount` API. Add an API that allows us to get a count of all ballistics objects.

2022-10-10

Add time to units stream (#191) Resolves #165

2022-10-09

Add Transform to Weapon Export (#190) * Weapon export now includes speed and heading Changed object.lua to export speed and heading for weapon. Added heading and speed fields to Weapon proto message. * Add Transform to Weapon Object Export - Removed speed and heading from weapon export - Added transform to export - Added necessary WeaponIntermediate struct and implementation to unwrap transform * Update CHANGELOG.md * Update CHANGELOG.md

2022-10-05

Scenery object have an integer as name, rename `name` to `id` and change the type to uint When listening to Dead events, no events where triggered for scenery objects. After looking at the logs I found out that the deserialization failed because the scenery struct expected a string but a number was given.

Add GetRealTime API

2022-10-04

Add detailed position/attitude information to unit (#162) * Add detailed position/attitude information to unit * Allow `large_enum_variant` in dcs-grpc-stubs

2022-10-03

Add getDetectedTargets method to controller Created GRPD.methods.getDetectedTarrgets which returns position, velocity, unit name, id, and optionally descriptors. Created exporter for detectedTarget. Added GetDetectedTargets rpc call to the controller service. Added GetDetectedTargetsRequest and Response message. controller proto now imports common proto. Defined common Contact proto message

Fixed protolint issues Updated 'descriptor' to 'descriptors' and adjusted line length of the service declaration to fit style guide.

Changed getDetectedTargets to optionally return unit or weapon object - Removed unused detectedTargets exporter - Added support for getDetectedTargets to handle weapon objects -Updated Common proto and Controller proto to accomodate new option 'includeObject' and return for objects.

Changed additional return to a oneof field Based on review recommendation, changed weapon / unit / basic information to be returned in a oneof field.

Rogue white space removal and updated changelog Fixed whitespace in common.proto.

Add detectionType param to getDetectedTargets - Added detectionType param to the GetDetectedTargetsRequest message. int values match detection values for DCS API. - Added if else statement to utilize detectionType - Changed basicInformation return type to just use the unknown object exporter.

2022-08-08

Return the full parent group with the unit When returning a unit object we will return the full group as its own object instead of embedding some group attributes in the unit object. This makes it easier for clients to parse streaming events without having to make separate calls to get group information or require them to keep a local copy in state that then needs to be managed.

2022-07-24

Add `GetAvailableSlots` API

2022-06-30

Add GetSessionId API

2022-06-29

Add SimulationFps event Calculate FPS by hooking into `onSimulationFrame` and fire an event every second containing the average FPS since the last event (~1s). Resolves #164

2022-06-22

Update MarkPanel initiator to be optional This is necessary as the initiator is not always defined. It is not defined when: - The player who created the mark panel isn't currently occupying any unit (e.g. when they left the server or moved to spectator) - The mark panel was created by a game master / jtac / or similar non- unit roles

2022-05-29

Add Mission Management APIs Add mission management APIs that allow clients to load and restart missions. The `LoadNextMission` API is apparently supposed to return false when the last mission in the mission list has been reached but DCS is returning true all the time. The APi to reload the current mission is not natively provided by DCS but is simple to implement and will be useful for admins I think.

2022-05-28

Make Hit/Kill event weaponName field optional Not all hit and kill events include a `weaponName` depending on what happened (For example one aircraft hitting another without the use of an intermediate weapon). This was causing many deserialization errors in the production logs of servers. Therefore we will make this field optional. I think that longterm we can come up with a better solution by removing the `weaponName` field entirely and only ever populating the `Weapon` field instead in lua. However this is a short-term fix for the next release.

2022-05-22

Get Static Objects API Retrieves all the statics populated to a coalition (or all!)

2022-05-20

Add `GetUnitType` API

2022-05-15

Add Static Objects API (`AddStaticObject` and `AddLinkedStatic`) (#144) Implementation of `addStaticObject` via the gRPC interface. Two API's were added as the behavior is slightly different that it did not need to justify an overloaded/oneof complex body. The cargo type is free text so to avoid the requirements of DCS-gRPC installations and clients to be coupled to any DCS updates / new units / renames * Static positioning * Linked unit * Cargo handling

2022-05-05

Add `GetTheatre` API (#142) Returns the theatre (map name) as a string. I chose to do it this way instead of an enum because it was simpler and would mean we don't need to update it when new maps come out.

Add `MarkupToAll` and `MarkupToCoalition` APIs Although there is no `MarkupToCoalition` in the scripting environment; we will add a gRPC level API for one to keep in line with the `MarkTo*` APIs. There is no way to do a `MarkupToGroup` so we are not implementing it.

2022-04-29

Add `OutTextForUnit` API

2022-04-19

Add `KickPlayer` API

Add `GetMissionFilename` API

Add `IsServer` and `IsMultiplayer` APIs

Add pause APIs Add the APIs that allow us to get and set the paused status of a server

Add `GetMissionDescription` API

Add ban related APIs Add ban related APIs. To get the ID to ban a player we use the `GetPlayers` API in the net service. Although these ban APIs are `net` APIs they are not available in the MSE, only the Hook environment, hence their being placed in the corresponding namespace.

Add `ExitProcess` API

2022-04-03

Add more detail to `GroupCommand` event. Replace `groupName` field in the `GroupCommand` event with all the group details as exposed by the group exporter (currently id, name, coalition and category). This change was made based on experience writing a client that processes these events where only having the groupName was a limitation. This change breaks backwards compatibility with version 0.4.0 where the `GroupCommand` event was first added.

2022-02-06

Add MissionCommand API support Add support for the `AddMissionCommand`, `AddMissionCommandSubMenu` and `RemoveMissionCommandItem` APIs along with their Coalition and Group variants which allow us to create F10 radio command menu entries and have them emit events to DCS-gRPC clients. Additionally it adds new CommandEvents which are triggered for any execution of a command via the F10 radio menu by the players.

Fill out static object fields in event stream Fill out some of the static objects fields for use in the event stream.

Fill out scenery object fields in event stream Fill out some of the scenery objects fields for use in the event stream.

2022-01-30

chore: add support for go bindings This commit implements support for generating official Go bindings by adding the `go_package` option to all proto sources.

2022-01-29

Add C# headers Add headers to the proto files that specify the namespace the generated C# files will live under. This is part of work to create a simple C# nuget package so clients to not have to re-invent the wheel in their own appications. There are already `Dcs.*` nuget packages so to avoid confusion and conflict I am putting these under `RurouniJones` as a unique namespace since we don't have a company or any name that is particularly unique and I will be publishing other C# DCS related packages so it is as good a place as any.

Rename Coalition GetPlayers to GetPlayerUnits This would align to the lua function registration

Linting `proto` files to conform to rules * Reformatted comment lines to wrap at char 80 * New lines on empty message bodies * Wrapping long RPC declarations when exceeding 80-chars

2022-01-28

Fixing `GroupCategory` Motivated by work in progress with PR #111. Communicating breaking changes and configuring to change log and updating behavior

Specify unit category in `StreamUnits` Primary motivation is to ensure consistency with the underlying `GetGroups` implementation. Additional benefit is that different polling rates may be specified to the different categories. This makes sense because jets fly faster than ground units!

2022-01-26

Linting: implemented suggestions for Coalition Primary motivation to be a commit is due to CHANGELOG.md update and for a discussion on the API itself being affected. Lint to disable the default SUFFIX to be "INVALID" nor "UNSPECIFICIED" on `SKILL_RANDOM` and `POINT_TYPE_RANDOM` because the mission designer experiences this as the default impelementation

2022-01-19

Emit when a player changes to a slot The DCS Control API should emit a special event to the gRPC clients that a player has changed a slot.

2022-01-17

Force Player Slot Selection Implementation of the `force_player_slot` function. There is only community knowledge on how this function operates; it is officially listed but not publicly documented.

2022-01-15

Correction to snake casing `remote_address` Not sure why the linter never caught the camel casing. My sincere apologies for overlooking this typo.

Correction to snake casing `remote_address` Not sure why the linter never caught the camel casing. My sincere apologies for overlooking this typo.

2022-01-14

GetPlayers returns all connected player attributes Getting the player info based on the players connected to the server. This is a combined loop of `net.get_player_list` and `net.get_player_info`. Notes about the player information which differs from official documentation. - locale is an undocumented attribute / would serve well for multilingual cases - ipAddr is actually `{address}:{port}` It was decided to perform the compound variation of the API. In theory, it should work effectively but needs to be verified by densely populated servers.

2022-01-12

SendChat and SendChatTo Initial implementation of the `net.*` namespace with the: - `send_chat_to` - `send_chat` `send_chat_to` does not implement the DCS API parameter of `fromPlayerId` due to the social impact of a player being emulated is more severe than a breached system and hence why the parameter has been redacted. If there is a valid use case, please do feel free to present your use case and why alternatives do not meet the user requirements. See PR #94 Added `net` as global read for lua linter

2022-01-07

Include chat messages in event stream. Include chat messages in the event stream Observers of the simulation events and the chat messages (and other server side events) would be difficult to synchronize the chronological order unless the process creates a Rx stream which would require latency to be introduced to synchronize the events. Therefore include Chat messages in the main event stream

2022-01-04

start custom events at field number 8192 This gives plenty of space in the enum for built-in events.

add DISCONNECT_REASON_UNSPECIFIED variant

add connect and disconnect events

2021-12-21

Add Custom APIs Add some more custom APIs for aborting missions and getting their statuses.

2021-12-18

add place to landingQualityMark event

2021-11-17

Format the protos format the protos using clang-format

2021-11-12

Add initial `AddGroup` implementation So far this implementation will create a ground group with a number of ground units and return null in the gRPC response for some reason. Many options are still hardcoded but what is currently implemented is enough to spawn a static SAM site such as a NASAM site and have it act as expected.

2021-11-11

add category to common.v0.Unit

2021-11-10

add GetTransform method to UnitService

2021-11-07

Version namespace the proto files Version namespace the proto files

2021-11-04

remove velocity vector from wind related responses

2021-11-03

add wind vector and move wind calculation to Rust

Add AIRBASE_CATEGORY_UNSPECIFIED Add AIRBASE_CATEGORY_UNSPECIFIED to the AirbaseCategory enum to bring it into line with recommendations on not having a semantic meaning to 0 index gRPC enums unless you specifically want to.

2021-11-02

Order Coalition package members alphabetically Makes it easier to scan through

Update coalition enum Update the coalition enum to add COALITION_ALL. We can actually use this new value in some APIs where specifying the coalition was optional.

2021-11-01

Make protolint happy Because doing so now may grant me brownie points when the robot uprising occurs. The only warnings left are for the Enums which I am also working on in the hope that it will spare me working in the silicon foundries.

Fix typo in field name

Increment Alarm State enum Increment the signal flare enum since gRPC does not recommend using zero indexed enums.

Increment Signal Flare enum Increment the signal flare enum since gRPC does not recommend using zero indexed enums. Fix smoke color to include validation while we are here.

2021-10-31

Proof of Concept for Enum renumbering gRPC does not recommend zero indexed Enums but DCS uses them a lot. Therefore this commit is a proof-of-concept for the easiest workaround I can think of. Pros: Simple. Cons: all lua using these enums will have to remember to -1 when the DCS enum is zero indexed (which is not all of them).

2021-10-30

Follow linting advice Eat crow and fix the things I thought I was being smart about and instead follow the recommendations of soulless linting programs. We are not following the suggestions for versioning the APIs at the end yet since are are still pre-stable. We will fix the enum warnings regarding the usage of `0` in a future commit Files formatted using clang-format

use cached start time for mag declination

add custom.GetMagneticDeclination method

Create a Common package. Create a common package and have all objects into it. This will be the lowest common denominator file that is depended on by others but has no dependencies.

Add API for getting coalition main reference point Add API for tetting the main reference point for a coaltion (aka the Bullseye).

2021-10-29

use consistent spaces indentation in proto files As defined in Google's proto style guide: https://developers.google.com/protocol-buffers/docs/style

add coalition and category to groups

add time offset to all positions When the position is used to track a unit over time it is important to correlate the position with a time. Since each request is async, the client can neither use the start or end of the request as a reference for the position. It is thus necessary to include a time reference for all positions.

add unit.GetUnit method

implement mission.GetMissionStartTime method

rename GetMissionStartTime to GetScenarioStartTime

add date fields to getTimeZero

add mission.GetScenarioCurrentTime

2021-10-27

split hook APIs into separate grpc package

split mission APIs into separate grpc package