Skip to content

Commit

Permalink
[Community] [Point and Orbit] Add the ability to point toward an angl…
Browse files Browse the repository at this point in the history 
…e (useful for gamepads) (#1281)

* Add the ability to point toward an angle (useful for gamepads)
* Make orbit follow the same speed as rotation.
* Minor text updates to the description
  • Loading branch information
@tristanbob
tristanbob authored May 15, 2024
1 parent f773ec3 commit 8a35791
Showing 1 changed file with 175 additions and 45 deletions.
220 changes: 175 additions & 45 deletions extensions/community/PointAndOrbit.json
View file
Original file line number Diff line number Diff line change
@@ -1,33 +1,46 @@
{
"author": "",
"category": "Movement",
"description": "# User can\n- Use the extension action multi times.\n- Point object toward position.\n- Orbit object around position.\n- Set the distance to orbit around.\n- Set the pointing speed.\n\n# Example\n![](https://i.imgur.com/N2KtaMT.png)",
"extensionNamespace": "",
"fullName": "Point and Orbit",
"helpPath": "",
"iconUrl": "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48IURPQ1RZUEUgc3ZnIFBVQkxJQyAiLS8vVzNDLy9EVEQgU1ZHIDEuMS8vRU4iICJodHRwOi8vd3d3LnczLm9yZy9HcmFwaGljcy9TVkcvMS4xL0RURC9zdmcxMS5kdGQiPjxzdmcgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayIgdmVyc2lvbj0iMS4xIiBpZD0ibWRpLWFycm93LWJvdHRvbS1yaWdodC1ib2xkLW91dGxpbmUiIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0Ij48cGF0aCBkPSJNOS44OCwxNS41NEw0LjIyLDkuODhMOS44OCw0LjIyTDE1LjU0LDkuODhMMTkuNzgsNS42NFYxOS43OEg1LjY0TDkuODgsMTUuNTRNMTcuNjYsMTAuNTlMMTUuNTQsMTIuNzFMOS44OCw3LjA1TDcuMDUsOS44OEwxMi43MSwxNS41NEwxMC41OSwxNy42NkgxNy42NlYxMC41OVoiIC8+PC9zdmc+",
"name": "PointAndOrbit",
"previewIconUrl": "https://resources.gdevelop-app.com/assets/Icons/arrow-bottom-right-bold-outline.svg",
"shortDescription": "Point an object toward a position and Orbit around a position.",
"version": "1.0.0",
"shortDescription": "Point and orbit an object toward a position or angle.",
"version": "1.1.0",
"description": [
"Move an object in a circle around a specific point while pointing the moving object away from the center of the circle.",
"This feature is useful in games for weapons or targeting indicators that move around a player character.",
"Orbit distance and rotation speed can be changed easily.",
"",
"The target position action can be used to follow the direction of the cursor.",
"The target angle action can be used to follow hte direction of a gamepad stick",
"",
"# Example",
"![](https://i.imgur.com/N2KtaMT.png)"
],
"origin": {
"identifier": "PointAndOrbit",
"name": "gdevelop-extension-store"
},
"tags": [
"point",
"orbit",
"toward",
"around"
],
"authorIds": [
"IRIhkkTTl2UHhfjrLTTH5GYwkYu1"
"IRIhkkTTl2UHhfjrLTTH5GYwkYu1",
"gqDaZjCfevOOxBYkK6zlhtZnXCg1"
],
"dependencies": [],
"eventsFunctions": [
{
"description": "Point and Orbit an object.",
"fullName": "Point and Orbit",
"description": "Point and Orbit an object toward a position.",
"fullName": "Point and Orbit toward a position",
"functionType": "Action",
"group": "",
"name": "PointAndOrbit",
"private": false,
"sentence": "Point _PARAM1_ at _PARAM5_ Xpos, _PARAM6_ Ypos, at _PARAM7_ pointing speed, and orbit around _PARAM2_ Xpos, _PARAM3_ Ypos, at _PARAM4_ distance",
"events": [
{
Expand All @@ -36,24 +49,26 @@
"actions": [
{
"type": {
"value": "MettreAutourPos"
"value": "ModVarScene"
},
"parameters": [
"Gun",
"GetArgumentAsNumber(\"OrbitXpos\")",
"GetArgumentAsNumber(\"OrbitYpos\")",
"GetArgumentAsNumber(\"OrbitDistance\")",
"AngleBetweenPositions(GetArgumentAsNumber(\"OrbitXpos\"),GetArgumentAsNumber(\"OrbitYpos\"),GetArgumentAsNumber(\"PointXpos\"),GetArgumentAsNumber(\"PointYpos\"))"
"__PointAndOrbit.TargetAngle",
"=",
"AngleBetweenPositions(OrbitXpos, OrbitYpos, PointXpos, PointYpos)"
]
},
{
"type": {
"value": "RotateTowardAngle"
"value": "PointAndOrbit::PointAndOrbitAngle"
},
"parameters": [
"",
"Gun",
"AngleBetweenPositions(GetArgumentAsNumber(\"OrbitXpos\"),GetArgumentAsNumber(\"OrbitYpos\"),GetArgumentAsNumber(\"PointXpos\"),GetArgumentAsNumber(\"PointYpos\"))",
"GetArgumentAsNumber(\"PointSpeed\")",
"OrbitXpos",
"OrbitYpos",
"OrbitDistance",
"Variable(__PointAndOrbit.TargetAngle)",
"PointSpeed",
""
]
}
Expand All @@ -62,73 +77,188 @@
],
"parameters": [
{
"codeOnly": false,
"defaultValue": "",
"description": "Gun object",
"longDescription": "The object that is going to orbit and rotate.",
"name": "Gun",
"optional": false,
"supplementaryInformation": "",
"type": "objectList"
},
{
"codeOnly": false,
"defaultValue": "",
"description": "Orbit around this X position",
"longDescription": "Gun object will orbit around this X position.",
"name": "OrbitXpos",
"optional": false,
"supplementaryInformation": "",
"type": "expression"
},
{
"codeOnly": false,
"defaultValue": "",
"description": "Orbit around this Y position",
"longDescription": "Gun object will orbit around this Y position.",
"name": "OrbitYpos",
"optional": false,
"supplementaryInformation": "",
"type": "expression"
},
{
"codeOnly": false,
"defaultValue": "",
"description": "Orbit distance (in pixels)",
"longDescription": "Distance between the Gun object and the Orbit positions X and Y. \nExample: 50 .",
"name": "OrbitDistance",
"optional": false,
"supplementaryInformation": "",
"type": "expression"
},
{
"codeOnly": false,
"defaultValue": "",
"description": "Point to this X position",
"longDescription": "Point the gun object to this Xposition.",
"name": "PointXpos",
"optional": false,
"supplementaryInformation": "",
"type": "expression"
},
{
"codeOnly": false,
"defaultValue": "",
"description": "Point to this Y position",
"longDescription": "Point the gun object to this Yposition.",
"name": "PointYpos",
"optional": false,
"supplementaryInformation": "",
"type": "expression"
},
{
"codeOnly": false,
"defaultValue": "",
"description": "Pointing speed (in deg/second)",
"longDescription": "Set to 0 for an immediate pointing.",
"name": "PointSpeed",
"optional": false,
"supplementaryInformation": "",
"type": "expression"
}
],
"objectGroups": []
},
{
"description": "Point and Orbit an object toward an angle.",
"fullName": "Point and Orbit toward an angle",
"functionType": "Action",
"name": "PointAndOrbitAngle",
"sentence": "Point _PARAM1_ towards _PARAM5_ degrees at _PARAM6_ pointing speed, and orbit around _PARAM2_ Xpos, _PARAM3_ Ypos, at _PARAM4_ distance",
"events": [
{
"colorB": 228,
"colorG": 176,
"colorR": 74,
"creationTime": 0,
"name": "Determine the orbit angle for the next frame (using the shortest path)",
"source": "",
"type": "BuiltinCommonInstructions::Group",
"events": [
{
"type": "BuiltinCommonInstructions::Standard",
"conditions": [
{
"type": {
"value": "BuiltinCommonInstructions::CompareNumbers"
},
"parameters": [
"mod(180 + TargetAngle - Gun.Angle(), 360)",
"<",
"180"
]
}
],
"actions": [
{
"type": {
"value": "ModVarScene"
},
"parameters": [
"__PointAndOrbit.NextFrameAngle",
"=",
"Gun.Angle() - (PointSpeed * TimeDelta())"
]
}
]
},
{
"type": "BuiltinCommonInstructions::Standard",
"conditions": [
{
"type": {
"value": "BuiltinCommonInstructions::CompareNumbers"
},
"parameters": [
"mod(180 + Gun.Angle() - TargetAngle, 360)",
"<",
"180"
]
}
],
"actions": [
{
"type": {
"value": "ModVarScene"
},
"parameters": [
"__PointAndOrbit.NextFrameAngle",
"=",
"Gun.Angle() + (PointSpeed * TimeDelta())"
]
}
]
}
],
"parameters": []
},
{
"type": "BuiltinCommonInstructions::Standard",
"conditions": [],
"actions": [
{
"type": {
"value": "MettreAutourPos"
},
"parameters": [
"Gun",
"OrbitXpos",
"OrbitYpos",
"OrbitDistance",
"Variable(__PointAndOrbit.NextFrameAngle)"
]
},
{
"type": {
"value": "RotateTowardAngle"
},
"parameters": [
"Gun",
"TargetAngle",
"PointSpeed",
""
]
}
]
}
],
"parameters": [
{
"description": "Gun object",
"longDescription": "The object that is going to orbit and rotate.",
"name": "Gun",
"type": "objectList"
},
{
"description": "Orbit around this X position",
"longDescription": "Gun object will orbit around this X position.",
"name": "OrbitXpos",
"type": "expression"
},
{
"description": "Orbit around this Y position",
"longDescription": "Gun object will orbit around this Y position.",
"name": "OrbitYpos",
"type": "expression"
},
{
"description": "Orbit distance (in pixels)",
"longDescription": "Distance between the Gun object and the Orbit positions X and Y. \nExample: 50 .",
"name": "OrbitDistance",
"type": "expression"
},
{
"description": "Angle",
"longDescription": "Point the gun object to this angle",
"name": "TargetAngle",
"type": "expression"
},
{
"description": "Pointing speed (in deg/second)",
"longDescription": "Set to 0 for an immediate pointing.",
"name": "PointSpeed",
"type": "expression"
}
],
Expand Down

0 comments on commit 8a35791

Please sign in to comment.